Sales > Payment Methods > Braintree

IMPORTANT
Commerce 2.4迁移:

对于2.4.0之前的Adobe Commerce和Magento Open Source版本,建议商家从Commerce Marketplace安装和配置官方Braintree支付集成扩展以替换核心集成。 从2.4.0开始,该扩展现已包含在核心版本中。



迁移到Commerce 2.4时,商家需要卸载Marketplace (paypal/module-braintreegene/module-braintree)上分发的扩展,并更新任何代码自定义设置,以使用PayPal_Braintree命名空间而不是Magento_Braintree。 Commerce的捆绑扩展和分布在Commerce Marketplace上的扩展中的配置设置会保留。 使用这些扩展版本进行的付款将正常捕获、失效或退款。



如果您要升级到Commerce 2.4.0,并且在之前的2.3.x版本中未使用推荐的Commerce Marketplace扩展,则多地址功能在2.4.0版本的Braintree中不起作用。 当购物者选择​_传送到多个地址_​时,未显示Braintree付款方式。 之前推荐用于2.3.x的Commerce Marketplace扩展存在此多地址问题。

要访问商店配置设置,请从​ 管理员 ​侧边栏中选择​ Stores > Settings>Configuration

Basic Braintree Settings

基本Braintree设置

字段
作用域
描述
Title
商店视图
默认值: Credit Card(Braintree)
Environment
商店视图
选项: Sandbox / Production
Payment Action
商店视图
确定Braintree在处理付款时执行的操作。 选项:
Authorize— 客户信用卡上的资金已授权,但未从帐户转帐。 将在您的商店管理员中创建订单。 您可以稍后捕获销售并创建发票。
Intent Sale(以前版本中的Authorize and Capture) — 客户信用卡上的资金由Braintree授权和捕获,并在您的商店管理员中创建了订单和发票。
Sandbox Merchant ID
商店视图
这是您整个沙盒网关帐户的唯一标识符。 也称为​ 公共ID ​或​ 生产ID,您的贸易商ID对于生产和沙盒网关是不同的。 当​ Environment ​字段设置为Sandbox时,将显示此字段。
Sandbox Public Key
商店视图
这是用户特定的公共标识符,用于限制对加密数据的访问。 与您的沙盒Braintree网关关联的每个用户都有自己的沙盒公钥。 当​ Environment ​字段设置为Sandbox时,将显示此字段。
Sandbox Private Key
商店视图
这是特定于用户的私有标识符,用于限制对加密数据的访问。 与您的沙盒Braintree网关关联的每个用户都有自己的沙盒私钥。 当​ Environment ​字段设置为Sandbox时,将显示此字段。
Merchant ID
商店视图
这是您整个网关帐户的唯一标识符,包括您的网关中可能存在的多个商家帐户。 也称为​ 公共ID ​或​ 生产ID,您的贸易商ID对于生产和沙盒网关是不同的。 当​ Environment ​字段设置为Production时,将显示此字段。
Public Key
商店视图
这是用户特定的公共标识符,用于限制对加密数据的访问。 与您的Braintree网关关联的每个用户都有自己的公钥。 当​ Environment ​字段设置为Production时,将显示此字段。
Private Key
商店视图
这是特定于用户的私有标识符,用于限制对加密数据的访问。 与您的Braintree网关关联的每个用户都有自己的私钥。 当​ Environment ​字段设置为Production时,将显示此字段。
Enable Card Payments
网站
确定Braintree信用卡付款方式是否适用于您的客户。 选项: Yes / No
Enable Vault for Card Payments
网站
启用后,将为客户付款信息提供安全存储,这样客户就不必在每次购买时都重新输入其信用卡信息。 选项: Yes / No
Enable Vault CVV Reverification
网站
启用后,将对Braintree帐户中的CVV规则设置进行验证。 选项: Yes / No

Advanced Braintree Settings

Braintree高级设置

字段
作用域
描述
Vault Title
网站
参考的描述性标题,用于标识存储客户卡信息的存储库。
Merchant Account ID
网站
要与此网站中的Braintree交易关联的商家帐户ID。 如果留空,则使用您Braintree帐户中的默认商家帐户。
Enable Checkout Express Payments
网站
在结账流程之初通过“快速付款”选项(包括PayPal、PayLater、Apple Pay和Google Pay)提供更快的结账体验。 选项: Yes / No
Skip Fraud Checks on Admin Orders
网站
仅当事务设置为Yes时,才阻止在通过管理员下单的订单上将该事务作为Advanced Fraud Tools检查的一部分发送以进行评估。
选项: Yes / No
Bypass Fraud Protection Threshold
网站
当达到或超过阈值时,绕过Advanced Fraud Protection检查。 将此字段留空将禁用此选项。
Debug
网站
确定Braintree系统和商店之间的通信是否记录在日志文件中。 选项: Yes / No
CVV Verification
网站
确定是否要求客户提供信用卡背面的三位数安全代码。 选项: Yes / No
Send Card Line Items
网站
发送所有付款方法的购物车行项目。 选项: Yes / No
Credit Card Types
网站
指定您接受作为通过Braintree付款的每种信用卡。 按住Ctrl(或Mac上的Command)以选择卡片组合。 选项: American Express / Visa / MasterCard / Discover / JCB / Diners / Maestro International
Sort Order
网站
确定结帐期间Braintree与其他支付方式一起列出的顺序。

Braintree Webhooks Settings

BraintreeWebhook设置

字段
作用域
描述
Enable Webhook
网站
启用webhook功能以进行欺诈防护、ACH支付、本地支付方法和争议。 选项: Yes / No
Fraud Protection URL
网站
将此URL作为Webhook Destination URL添加到您的Braintree帐户中。 此URL必须是安全的且可公开访问的。
Fraud Protection Approve Order Status
网站
当Braintree批准防欺诈功能后,选定的订单状态将分配给Commerce订单。 此状态用于更新使用ACH付款方式以及订单在Braintree中移至SETTLED时的订单状态。
Fraud Protection Reject Order Status
网站
当Braintree拒绝欺诈防护时,选定的订单状态将分配给Commerce订单。 此状态用于更新使用ACH付款方法且SETTLEMENT在Braintree中为DECLINED的订单的状态。

Country Specific Settings

国家/地区特定的设置

字段
作用域
描述
Payment from Applicable Countries
网站
确定您是接受所有国家/地区的Braintree处理的付款,还是仅接受特定国家/地区的付款。 选项: All Allowed Countries / Specific Countries
Payment from Specific Countries
网站
如果适用,请确定您接受Braintree处理付款的特定国家/地区。
Country Specific Credit Card Types
网站
标识Braintree处理的付款按国家/地区接受的信用卡。 将为每个国家/地区保存记录。 选项:
Country— 选择国家/地区。
Allowed Card Types — 选择从国家/地区接受为通过Braintree付款的每个信用卡。
Add— 添加行以允许其他国家/地区的信用卡。
Action — 删除国家/地区允许的信用卡记录。

ACH through Braintree

通过Braintree 进行ACH

字段
作用域
描述
Enabled ACH Direct Debit
网站
确定是否通过Braintree将ACH Direct Debit作为付款方式包括在内。 选项: Yes / No
Enable Vault for ACH Direct Debit
网站
客户可以保险存储/存储其一次性使用的ACH直接借记支付方式以供将来使用。 保存付款详细信息后,客户可以使用ACH直接借记支付方式,而无需重新输入数据或重新验证其付款信息。 选项: Yes / No
Sort Order
网站
确定在结帐期间将ACH Direct Debit与其他付款方法一起列出的顺序。

Apple Pay through Braintree

Apple通过Braintree支付

字段
作用域
描述
Enable ApplePay through Braintree
网站
确定是否通过Braintree将Apple Pay作为付款方式包括在内。 选项: Yes / No

域必须先在Braintree帐户🔗中进行验证。
Enable Vault for ApplePay
网站
客户可以保险库/存储其Apple Pay支付方式以供将来使用。 保存付款详细信息后,客户可以使用Apple Pay,而无需重新输入数据或重新验证其付款信息。 选项: Yes / No
Payment Action
网站
确定Braintree在处理付款时执行的操作。 选项:
Authorize— 客户卡上的资金已授权,但未从客户帐户转帐。 将在您的商店管理员中创建订单。 您可以稍后捕获销售并创建发票。
Intent Sale — 客户卡上的资金由Braintree授权并捕获,并在您的商店管理员中创建订单和发票。 注意: ​在2.3.x及更早版本中,此值为Authorize and Capture
Merchant Name
商店视图
在ApplePay弹出窗口中向客户显示的标签。
Sort Order
网站
确定在结账过程中Apple Pay与其他支付方式一起列出的顺序。

Local Payment Methods

本地付款方式

字段
作用域
描述
Enabled Local Payment Methods
网站
确定是否通过Braintree将本地付款方法作为付款方法包括在内。 选项: Yes / No
Title
网站
在结账支付方式部分显示的标签。 默认值: Local Payments
Fallback Button Text
网站
输入要用于按钮的文本,该按钮显示在将客户带回网站的回退Braintree页面上。 默认值: Complete Checkout
Redirect on Fail
网站
指定当本地支付方式交易被取消、失败或遇到错误时,应重定向客户的URL。 它应该是结帐付款页面(例如,https://www.domain.com/checkout#payment)。
Allowed Payment Method
网站
选择要启用的本地付款方式。 选项: Bancontact / EPS / giropay / iDeal / Klarna Pay Now / SOFORT / MyBank / P24 / SEPA/ELV Direct Debit (尚未支持)
Sort Order
网站
确定结帐期间本地支付方式与其他支付方式一起列出的顺序。
NOTE
捆绑的Braintree扩展不支持Braintree开发人员文档中列出的所有本地付款方法。 其他本地支付方法正在开发中,将在未来版本中提供支持。

GooglePay through Braintree

通过Braintree GooglePay

字段
作用域
描述
Enabled GooglePay through Braintree
网站
确定是否通过Braintree将Google Pay付款作为付款方式包括在内。 选项: Yes / No
Enable Vault for GooglePay
网站
客户可以保险库/存储其Google Pay支付方式以供将来使用。 保存付款详细信息后,客户可以使用Google Pay,而无需重新输入数据或重新验证其付款信息。 选项: Yes / No
Payment Action
网站
确定Braintree在处理付款时执行的操作。 选项:
Authorize— 客户卡上的资金已授权,但未从客户帐户转帐。 将在您的商店管理员中创建订单。 您可以稍后捕获销售并创建发票。
Intent Sale — 客户卡上的资金由Braintree授权并捕获,并在您的商店管理员中创建订单和发票。 注意: ​在2.3.x及更早版本中,此值为Authorize and Capture
Button Color
网站
确定Google Pay按钮的颜色。 选项: White / Black
Merchant ID
商店视图
必须在此处输入由Google提供的ID。
Accepted Cards
网站
选择客户可以使用Google Pay下订单的卡片类型。
Sort Order
网站
确定在结账过程中Google Pay与其他支付方式一起列出的顺序。

Venmo through Braintree

通过Braintree 的Venmo

字段
作用域
描述
Enable Venmo through Braintree
网站
确定是否通过Braintree将Venmo作为付款方式包括在内。 选项: Yes / No
Enable Vault for Venmo
网站
客户可以保存/存储其Venmo支付方式以供将来使用。 一旦付款详细信息存入电子仓库,客户就可以使用Venmo付款方法,而无需重新输入数据或重新验证其付款信息。 选项: Yes / No
Payment Action
网站
确定Braintree在处理付款时执行的操作。 选项:
Authorize— 客户卡上的资金已授权,但未从客户帐户转帐。 将在您的商店管理员中创建订单。 您可以稍后捕获销售并创建发票。
Intent Sale — 客户卡上的资金由Braintree授权并捕获,并在您的商店管理员中创建订单和发票。 注意: ​在2.3.x及更早版本中,这是​ Authorize and Capture
Sort Order
网站
确定在结帐期间将Venmo与其他付款方法一起列出的顺序。

PayPal through Braintree

通过Braintree PayPal {width="550" modal="regular"}

字段
作用域
描述
Enable PayPal through Braintree
网站
确定是否通过Braintree将PayPal作为付款方式包括在内。 选项: Yes / No
Enable PayPal Credit through Braintree
网站
确定是否通过Braintree将PayPal点数作为付款方式包括在内。 选项: Yes / No。 当Enable PayPal through Braintree设置为Yes时,此字段可见
Enable PayPal PayLater through Braintree
网站
确定是否通过Braintree将PayPal PayLater作为付款方式包括在内。 选项: Yes / No。 当Enable PayPal through Braintree设置为Yes时,此字段可见
Title
商店视图
在结帐期间通过Braintree给客户来标识PayPal的标签。 默认值: PayPal
Vault Enabled
网站
启用后,为客户支付信息提供安全存储,因此客户不必在每次购买时都重新输入其PayPal信息。 选项: Yes / No
Send Cart Line Items for PayPal
网站
将行项目(订单项目)与礼品卡、项目礼品包装、订单礼品包装、商店退款、配送和税作为行项目发送到PayPal。 选项: Yes / No
Sort Order
网站
一个数字,用于确定PayPal在结账过程中通过Braintree时与其他支付方式一起列出的顺序。
Override Merchant Name
商店视图
可用于为每个商店视图标识商家的替代名称。
Payment Action
网站
确定PayPal在处理付款时通过Braintree执行的操作。 选项:
Authorize— 客户卡上的资金已授权,但未从客户帐户转帐。 将在您的商店管理员中创建订单。 您可以稍后捕获销售并创建发票。
Authorize and Capture - PayPal通过Braintree授权并获取客户卡上的资金,并在您的商店管理员中创建订单和发票。
Payment from Applicable Countries
网站
确定您是否接受由PayPal通过所有国家/地区的Braintree处理的付款,或仅接受特定国家/地区的付款。 选项: All Allowed Countries / Specific Countries
Payment from Specific Countries
网站
如果适用,请确定您接受Braintree处理付款的特定国家/地区。
Require Customer’s Billing Address
网站
确定是否要求客户的帐单地址来提交订单。 选项: Yes / No
Debug
网站
确定PayPal通过Braintree系统和您的商店之间的通信是否记录在日志文件中。 选项: Yes / No
Display on Shopping Cart
网站
确定PayPal按钮是否出现在迷你购物车购物车页面上。 选项: Yes / No
NOTE
可以启用​ PayPal Credit ​或​ PayPal PayLater。 无法同时启用这两种方法。

Styling

PayPal样式

字段
作用域
描述
Location
网站
确定PayPal按钮和消息在店面中的呈现位置。 选项: Mini-Cart and Cart Page / Checkout Page / Product Page

Mini-Cart and Cart Page

此部分中的选项和设置因​ Location ​字段中的设置而异。

字段
作用域
描述
PayPal Button Type
网站
将按钮设置为三种类型之一: PayPal Button / PayPal Pay Later Button / PayPal Credit Button

PayPal Button

此部分中的选项和设置因在​ PayPal Button Type ​字段中选择的按钮类型而异。

字段
作用域
描述
Show PayPal Button
网站
确定PayPal按钮在选定位置的位置。 选项: Yes / No
Button Label
网站
确定PayPal按钮的标签。 选项: Paypal / Checkout / Buy Now / Pay
Color
网站
确定PayPal按钮的颜色。 选项: Blue / Black / Gold / Silver
Shape
网站
确定PayPal按钮的形状。 选项: Pill / Rectangle
Size(Deprecated)
网站
确定PayPal按钮的大小。 选项: Medium / Large / Responsive
NOTE
Size(Deprecated) ​配置字段已弃用,未用于设置PayPal按钮的样式。

PayLater Messaging

字段
作用域
描述
Show PayLater Messaging
网站
在选定位置启用PayLater消息传送。 选项: Yes / No。 启用后,它将显示可用优惠的PayLater消息(限制适用)。
Message Layout
网站
确定PayLater消息布局。 选项: Text / Flex
Logo
网站
确定用于PayPal按钮的徽标类型。 选项: Inline / Primary / Alternative / None
Logo Position
网站
确定PayPal按钮的徽标位置。 选项: Left / Right / Top
Text Color
网站
确定PayPal按钮的文本颜色。 选项: Black / White / Monochrome / Grayscale

设置这些选项后,您可以看到PayPal按钮和PayLater消息的预览。 可以使用以下控件来应用设置或重置值:

字段
作用域
描述
Apply
网站
存储按钮和PayLater消息传递的选定样式设置,并将它们应用到当前位置和当前按钮类型。
Apply to All Buttons
网站
存储按钮和PayLater消息值的选定样式设置并将它们应用于所有按钮类型和位置。
Reset to Recommended Defaults
网站
将样式设置返回到按钮和PayLater消息传递的推荐默认值,并将它们应用于所有按钮类型和位置。

3d安全验证设置

3D安全验证设置

字段
作用域
描述
3D Secure Verification
网站
确定当客户注册诸如​ 由VISA验证 ​之类的计划时,交易是否必须通过额外的验证流程。 选项: Yes / No
Always request 3DS
网站
始终针对所有事务质询3D Secure请求。 选项: Yes / No
Threshold Amount
网站
确定单个订单上授权处理的最大订单金额。 如果订单金额超过此阈值金额,则Braintree拒绝授权。
Verify for Applicable Countries
网站
确定必须验证付款的国家/地区。 选项: All Allowed Countries / Specific Countries
Verify for Specific Countries
网站
如果适用,请指明必须对其进行Braintree付款验证的特定国家/地区。

Dynamic Descriptors

动态描述符

字段
作用域
描述
Name
商店视图
名称描述符分为两部分,以星号(*)分隔。 描述符的第一部分标识公司或DBA,第二部分标识产品。 例如: company*myproduct

描述符的公司和产品部分的长度可以通过以下方式进行分配,组合长度最多为22个字符:
Option 1— 公司必须是3个字符/产品最多可以是18个字符
Option 2 — 公司必须是7个字符/产品最多可以是14个字符​
Option 3— 公司必须是12个字符/产品最多可以是9个字符
Phone
商店视图
电话描述符的长度必须为10到14个字符,并且只能包含数字、破折号、圆括号和句点。 例如: 9999999999 (999) 999-9999 999.999.9999
URL
商店视图
URL描述符表示您的域名,最长可为13个字符。 例如: company.com
recommendation-more-help
d39aca6f-58a0-41c6-83eb-39fd0ef30672