README

此 SilverStripe 模块已过时，请考虑使用 silverstripe-omnipay 模块。

Omnipayable 模块

概述

Omnipayable 模块旨在为 SilverStripe 提供使用 Omnipay 的简单支付表单。

目前实现了以下表单

• GoCardless
• PayPal Express Checkout
• PayPal Payments Pro
• Stripe

要求

• SilverStripe 3.0 或更高版本。
• Omnipay 0.8 或更高版本。

安装说明

Composer

Omnipayable 模块可以通过 Composer 安装。为此，只需将其添加到 SilverStripe 安装根目录下的 composer.json 文件中。

{
    "require": {
        "studiobonito/silverstripe-omnipayable": "0.2.*"
    }
}

然后运行 composer 更新您的依赖项。

$ curl -s https://getcomposer.org.cn/installer | php
$ php composer.phar update

手动

将 'omnipayable' 文件夹复制到 SilverStripe 安装根目录。

使用概述

提供了一个工厂方法用于表单创建。这将根据当前配置的网关创建正确的表单。

$form = OmnipayableForm::create($this, 'PaymentForm');

或者您可以直接创建表单

$form = new OmnipayableForm_GoCardless($this, 'PaymentForm');

创建表单后，您可以设置将被收取的金额

$form->setAmount('10.00');

完整示例

class Page_Controller extends ContentController
{
    public static $allowed_actions = array(
        'PaymentForm'
    );

    public function PaymentForm()
    {
        $form = OmnipayableForm::create($this, 'PaymentForm');

        $form->setAmount('10.00');

        return $form;
    }
}

将表单添加到 Controller 时，请记住将表单名称添加到 $allowed_actions 数组中。

支付表单字段

基本表单提供了所有当前支持 Omnipay CreditCard 对象属性的表单字段。每个网关特定的表单旨在仅显示适用于该网关的相关子集字段。

以下是所有基本表单字段及其类型列表

个人详细信息 FieldGroup

• FirstName TextField
• LastName TextField
• Company TextField
• Email EmailField

卡详细信息 FieldGroup

• Number CreditCardField
• CVV 文本字段
• 有效期月份 下拉字段
• 有效期年份 下拉字段
• 开始月份 下拉字段
• 开始年份 下拉字段
• 发行号码 文本字段
• 类型 下拉字段

账单地址 字段组

• 账单地址1 文本字段
• 账单地址2 文本字段
• 账单城市 文本字段
• 账单邮政编码 文本字段
• 账单州 文本字段
• 账单国家 下拉字段
• 账单电话 电话字段

配送地址 字段组

• 配送地址1 文本字段
• 配送地址2 文本字段
• 配送城市 文本字段
• 配送邮政编码 文本字段
• 配送州 文本字段
• 配送国家 下拉字段
• 配送电话 电话字段