README

Braintree for Craft Commerce

此插件为Braintree和Craft Commerce提供集成。

功能

• 商家账户：支持多货币支付。
• 订阅：支持订阅集成。
• DropinUi：默认为getPaymentFromHTML()方法。
• 支持3DSecure 2。
• 支持PayPal、Apple Pay和Google Pay。
• 安全存储：支持Braintree的安全存储以安全存储支付详情。

需求

此插件需要Craft Commerce 4.0或更高版本。

安装

您可以从插件商店或使用Composer安装此插件。

从插件商店

转到项目控制面板中的插件商店，搜索“Braintree for Craft Commerce”，然后在弹出的窗口中点击“安装”按钮。

使用Composer

打开终端并运行以下命令

# go to the project directory
cd /path/to/my-project.test

# tell Composer to load the plugin
composer require webdna/commerce-braintree

# tell Craft to install the plugin
./craft plugin/install commerce-braintree

设置

要添加Braintree支付网关，请转到“ Commerce → 设置 → 网关”，创建一个新的网关，并将网关类型设置为“Braintree”。

支付安全强制执行

此插件不允许直接将信用卡详情提交给Braintree网关。相反，在提交支付表单之前，您必须对卡进行标记。在网关上调用默认的getPaymentFormHtml()方法将自动使用Braintree的DropinUI界面并标记支付详情。如果您希望控制dropinUi选项或希望使用Braintree的HostedFields，则需要手动添加字段和javascript，而不是使用默认方法。

3D安全支付

要允许3D安全支付，您必须在您的Braintree账户中启用它，然后通过可选参数传递给getPaymentFormHtml()方法。默认：false

gateway.getPaymentFormHtml({threeDSecure:true})

选项

这些是可以传递给默认的getPaymentFormHtml()方法的选项。

商店名称

这将设置PayPal、Google Pay和Apple Pay的商店名称。默认：siteName

gateway.getPaymentFormHtml({storeName:'My WebSite'})

翻译

这将允许设置dropinUi翻译：示例

gateway.getPaymentFormHtml({translations:{chooseAWayToPay:'Choose a way to pay'}})

安全存储

这允许将支付详情存储在Braintree的安全存储中，而不是网站上。DropinUi将显示所有保存的支付方式。默认：false

gateway.getPaymentFormHtml({vault:true})

如果您希望允许管理安全存储的支付方式，则必须传递manage选项。默认：false

gateway.getPaymentFormHtml({manage:true})

订阅

创建订阅计划

1. 要创建订阅计划，它必须首先在您的Braintree账户中创建。
2. 转到“ Commerce → 设置 → 订阅计划”并创建一个新的订阅计划。

订阅选项

试用期天数

试用期天数是作为计划的一部分在Braintree中设置的。

在不同订阅计划之间切换时的选项

prorate参数

如果此参数设置为true，则订阅切换将进行比例调整。