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 (
如果您要升级到Commerce 2.4.0,并且在之前的2.3.x版本中未使用推荐的Commerce Marketplace扩展,则多地址功能在2.4.0版本的Braintree中不起作用。 当购物者选择_传送到多个地址_时,未显示Braintree付款方式。 之前推荐用于2.3.x的Commerce Marketplace扩展存在此多地址问题。
对于2.4.0之前的Adobe Commerce和Magento Open Source版本,建议商家从Commerce Marketplace安装和配置官方Braintree支付集成扩展以替换核心集成。 从2.4.0开始,该扩展现已包含在核心版本中。
迁移到Commerce 2.4时,商家需要卸载Marketplace (
paypal/module-braintree
或gene/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
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
{width="550" modal="regular"}
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
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
进行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
Enable ApplePay through 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
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
的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 {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
NOTE
可以启用 PayPal Credit 或 PayPal PayLater。 无法同时启用这两种方法。
Styling
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
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 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,第二部分标识产品。 例如:
描述符的公司和产品部分的长度可以通过以下方式进行分配,组合长度最多为22个字符:
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