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 环境。

此网关仅支持通过令牌（支付非确定数）进行购买。您可以生成用于 Javascript 的客户端令牌

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

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

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

使用 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 标签，以便易于找到。

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

如果您认为您发现了一个错误，请使用GitHub问题追踪器报告它，或者更好的方法是fork库并提交一个pull请求。