README

将 Braintree 的 API 集成到 Yii2 中以实现信用卡支付表单。灵感来源于 braintreeapi。

安装

推荐通过 composer 安装此扩展。

运行以下命令之一

php composer.phar require --prefer-dist tuyakhov/yii2-braintree "*"

或

"tuyakhov/yii2-braintree": "*"

将以下内容添加到您的 composer.json 文件的 require 部分。

用法

首先应将 Braintree 组件添加到您的 Yii 配置中

'components' => [
    'braintree' => [
        'class' => 'tuyakhov\braintree\Braintree',
        'merchantId' => 'YOUR_MERCHANT_ID',
        'publicKey' => 'YOUR_PUBLIC_KEY',
        'privateKey' => 'YOUR_PRIVATE_KEY',
    ],
]

扩展安装后，您可以通过以下方式在代码中使用它：

BraintreeForm 提供所有基本操作（销售和存储客户信息）。操作名称等于场景名称。可用场景

creditCard - 创建一张信用卡 文档
address - 创建一个地址 文档
customer - 创建一个客户 文档
sale - 创建一个交易 文档
saleFromVault - 从您的 Vault 中创建一个交易 文档

动作示例

public function actionSale() {
    $model = new BraintreeForm();
    $model->setScenario('sale');
    if ($model->load(Yii::$app->request->post()) && $model->send()) {
        // do something
    }
    return $this->render('purchase', ['model' => $model]);
}

视图中的表单小部件

<?php $form = \tuyakhov\braintree\ActiveForm::begin(); ?>
<?= $form->field($model, 'creditCard_number'); ?>
<?= $form->field($model, 'creditCard_cvv'); ?>
<?=
$form->field($model, 'creditCard_expirationDate')->widget(
    \yii\widgets\MaskedInput::className(),
    ['mask' => '99/9999']
);
?>
<?= $form->field($model, 'amount'); ?>
<?= \yii\helpers\Html::submitButton(); ?>
<?php \tuyakhov\braintree\ActiveForm::end(); ?>