README

Braintree用于Omnipay PHP支付处理库的驱动程序

Omnipay 是一个不依赖于框架、多网关的PHP 5.3+支付处理库。本包实现了Omnipay对Braintree的支持。

安装

Omnipay通过 Composer 安装。要安装，只需将其添加到您的 composer.json 文件中

composer require omnipay/braintree:"~2.0@dev"

基本用法

本包提供了以下网关

• Braintree

您需要设置 merchantId、publicKey 和 privateKey。将 testMode 设置为 true 将使用 sandbox 环境。

此网关仅支持通过令牌（支付nonce）进行购买。您可以为Javascript生成一个clientToken

$clientToken = $gateway->clientToken()->send()->getToken();

生成的令牌在您使用Javascript SDK显示Drop-in Payment UI或收集支付方法信息的托管字段时非常有用。

在成功提交支付表单后，将动态地将一个一次性令牌（引用您的客户提供的支付方法，如信用卡或PayPal帐户）添加到表单中，作为隐藏的payment_method_nonce输入字段的值。

使用 payment_method_nonce 处理您的客户订单，如下所示

$response = $gateway->purchase([
            'amount' => '10.00',
            'token' => $_POST['payment_method_nonce']
        ])->send();

有关一般用法说明，请参阅主要的 Omnipay 存储库。

特定驱动程序的使用

创建客户

$customer = $gateway->createCustomer([
    'customerData' => [
        'id' => 1,
        'firstName' => 'John',
        'lastName' => 'Doe'
    ]
])->send();

您可以在此处找到完整的选项列表。

###通过id查找客户

$customer = $gateway->findCustomer(1)->send();

您可以在此处找到完整的选项列表

创建支付方法

$method = $gateway->createPaymentMethod([
    'customerId' => $user->getId(),
    'paymentMethodNonce' => 'paymentnonce',
    'options' => [
        'verifyCard' => true
    ]
]);

您可以在此处找到完整的选项列表

更新支付方法

$method = $gateway->updatePaymentMethod([
    'paymentMethodToken' => 'token123',
    'options' => [
        'paymentMethodNonce' => 'paymentnonce'
    ]
]);

您可以在此处找到完整的选项列表

###创建订阅

$subscription = $gateway->createSubscription([
    'subscriptionData' => [
        'paymentMethodToken' => 'payment_method_token',
        'planId' => 'weekly',
        'price' => '30.00'
    ]
])->send();

您可以在此处找到完整的选项列表

###取消订阅

$subscription = $gateway->cancelSubscription('id')->send();

您可以在此处找到完整的选项列表

###解析webhook通知

$notification = $gateway->parseNotification([
    'bt_signature' => 'signature',
    'bt_payload' => 'payload'
])->send();

您可以在此处找到完整的选项列表

支持

如果您在使用Omnipay时遇到一般问题，我们建议在Stack Overflow 上发布。请确保添加 omnipay 标签，以便更容易找到。

如果您想了解发布公告，讨论项目的想法或提出更详细的问题，还有一个邮件列表，您可以订阅。

如果您认为发现了bug，请使用GitHub问题跟踪器进行报告，或者更好的方法是分叉库并提交一个pull请求。