Braintree
Braintree通过欺诈检测和PayPal集成，提供完全可自定义的结账体验。 它支持Apple Pay、Google Pay、ACH、Venmo和本地支付方式。 Braintree减轻了商家的PCI合规负担，因为交易发生在Braintree系统上。 Braintree支付集成由GENE Commerce开发。
步骤1：获取Braintree凭据
转到Braintree付款并注册帐户。
第2步：完成基本设置
-
在 管理员 侧边栏上，转到 Stores > Settings>Configuration。
-
在左侧面板中，展开 Sales 并选择 Payment Methods。
-
如果您的Commerce安装有多个网站、商店或视图，请在左上角选择应用配置的 Store View。
-
在 Merchant Location 部分中，验证 Merchant Country 是否设置为您公司的位置。
-
-
在 Recommended Solutions 下，在_Braintree Payments (由GENE Commerce v4.6.1 - 发行说明_部分，单击 Configure。
-
对于 Title，输入在结账期间将Braintree标识为付款选项的标题。
-
将Braintree交易记录的当前操作 Environment 设置为
Sandbox或Production在沙盒中测试配置时，仅使用Braintree推荐的信用卡号。 当您准备好使用Braintree进入生产时，将 Environment 设置为
Production。
-
将 Payment Action 设置为以下项之一：
Authorize Only— 批准购买并暂停资金。 在商户捕获__销售之前，不会从客户的银行帐户提取此金额。|Intent Sale— 已授权并立即从客户帐户中收回购买金额。 注意： 在2.3.x及更早版本中，此值是 Authorize and Capture。|
-
输入Braintree帐户中的 Sandbox Merchant ID / Merchant ID。
-
从您的Braintree帐户输入以下凭据：
- Sandbox Public Key / Public Key
- Sandbox Private Key / Private Key
note note NOTE （沙盒和生产） 环境都有单独的字段，而其他字段则根据所选择的环境进行渲染。 -
在保存配置之前，单击 Validate Credentials 验证您的凭据。
-
将 Enable Card Payments 设置为
Yes。
如果您希望能够安全地存储客户信息，以便客户不必在每次购买时都重新输入该信息，请将 Enable Vault for Card Payments 设置为
Yes。
步骤3：完成高级设置
-
展开 Advanced Braintree Settings 部分的
-
对于 Vault Title，请输入参考的描述性标题，以标识存储客户卡信息的保管库。
-
输入Braintree帐户中的 Merchant Account ID。
如果未指定要使用的贸易商帐户，则Braintree将使用默认贸易商帐户处理事务处理。
-
要在结账流程开始时使用“快速付款”选项(包括PayPal、PayLater、Apple Pay和Google Pay)提供更快的结账体验，请将 Enable Checkout Express Payments 设置为
Yes。 -
如果您希望阻止在高级欺诈工具检查过程中发送交易以进行评估，请将 Skip Fraud Checks on Admin Orders 设置为
Yes。 -
设置 Bypass Fraud Protection Threshold，以便在达到或超过阈值时绕过
Advanced Fraud Protection检查。将此字段留空将禁用此选项。
-
如果希望系统保存存储与Braintree之间交互的日志文件，请将 Debug 设置为
Yes。 -
若要要求客户从信用卡背面提供三位数的安全代码，请将 CVV Verification 设置为
Yes。如果使用CVV验证，请确保在Braintree帐户的 设置/处理 部分中启用AVS和/或CVV。
-
若要发送所有付款方法的购物车行项目，请将 Send Card Line Items 设置为
Yes。 -
对于 Credit Card Types，请选择商店接受的每个通过Braintree付款的信用卡。
要选择多种卡类型，请按住Ctrl键(PC)或Command键(Mac)并单击每个选项。
-
对于 Sort Order，请输入一个数字以确定在结账过程中与其他付款方法一起列出Braintree时显示的顺序。
步骤4：完成Braintreewebhook设置
-
将 Enable Webhook 设置为
Yes以启用webhook功能以防止欺诈、ACH付款和本地付款方法。 -
复制 Fraud Protection URL 字段中的URL并将其作为 Webhook Destination URL 添加到您的Braintree帐户。
note important IMPORTANT 此URL必须安全且可公开访问。 -
设置 Fraud Protection Approve Order Status 字段以确定Braintree何时批准欺诈防护。
选定的订单状态将分配给Commerce订单。
-
设置 Fraud Protection Reject Order Status 字段以确定Braintree何时拒绝欺诈防护。
选定的订单状态将分配给Commerce订单。
步骤5：完成特定于国家/地区的设置
-
将 Payment from Applicable Countries 设置为以下项之一：
All Allowed Countries— 来自您商店配置中指定的所有国家/地区的客户都可以使用此付款方式。Specific Countries— 选择此选项后，将显示 Payment from Specific Countries 列表。 按住Ctrl键(PC)或Command键(Mac)，然后选择客户可在您的商店中购买产品的每个国家/地区。
-
要设置 Country Specific Credit Card Types：
-
单击 Add。
-
设置 Country 并选择每个 Allowed Credit Card Type。
-
重复以上步骤以标识从每个国家/地区接受的信用卡。
-
步骤6：通过Braintree设置完成ACH
-
若要将ACH作为付款选项包含在Braintree中，请将 Enable ACH Direct Debit 设置为
Yes。 -
客户可以保存其单次使用的ACH直接借记支付方法并将其存储以供将来使用。 保险存储完成后，如果将 Enable Vault for ACH Direct Debit 设置为
Yes，客户可以重用ACH直接借记，而无需重新输入或验证其付款信息。 -
对于 Sort Order，输入一个数字，以确定在结帐期间与其他付款选项一起列出时，BraintreeACH付款选项出现的顺序。
步骤7：通过Braintree设置完成Apple Pay
通过Braintree设置
-
若要将Apple Pay作为付款选项包含在Braintree中，请将 Enable ApplePay through Braintree 设置为
Yes。确保首先在你的Braintree帐户中验证你的域名。
-
如果您希望能够安全地存储客户信息，以便客户在每次使用Apple Pay购买时都不需要重新输入该信息，请将 Enable Vault for ApplePay 设置为
Yes。 -
将 Payment Action 设置为以下项之一：
Authorize Only— 批准购买并暂停资金。 在商户捕获 销售额 之前，不会从客户的银行帐户提取此金额。Intent Sale— 已授权并立即从客户帐户中收回购买金额。
-
对于 Merchant Name，输入指定在Apple支付对话框中向客户显示的标签的文本。
-
对于 Sort Order，输入一个数字以确定在结帐期间与其他付款选项一起列出Apple Pay付款选项时显示的顺序。
步骤8：完成本地支付方法的设置
-
若要将本地付款方法作为付款选项包含在Braintree中，请将 Enable Local Payment Methods 设置为
Yes。 -
对于 Title，输入要用于显示在结帐付款方式部分上的标签的文本（默认值：
Local Payments）。 -
对于 Fallback Button Text，输入要用于后备Braintree页面上显示的按钮的文本，以将客户带回网站（例如，
Complete Checkout）。 -
对于 Redirect on Fail，输入URL，当本地付款方式交易被取消、失败或遇到错误时，应将客户重定向到该位置。 它应该是结帐付款页面（例如，
https://www.domain.com/checkout#payment）。 -
对于 Allowed Payment Methods，选择要启用的本地付款方式。
选项：
Bancontact/EPS/giropay/iDeal/Klarna Pay Now/SOFORT/MyBank/P24/SEPA/ELV Direct Debit（尚未支持）
note note NOTE 捆绑的Braintree扩展不支持Braintree开发人员文档中列出的所有本地付款方法。 其他本地支付方法正在开发中，将在未来版本中提供支持。 -
对于 Sort Order，请输入一个数字以确定在结帐期间与其他付款选项一起列出时本地付款方法的显示顺序。
步骤9：通过Braintree设置完成Google Pay
-
若要将Google Pay作为付款选项包含在Braintree中，请将 Enable GooglePay Through Braintree 设置为
Yes。 -
如果您希望能够安全地存储客户信息，以便客户在每次使用Google Pay购买时都不需要重新输入该信息，请将 Enable Vault for GooglePay 设置为
Yes。 -
将 Payment Action 设置为以下项之一：
Authorize Only— 批准购买并暂停资金。 在商户捕获 销售额 之前，不会从客户的银行帐户提取此金额。Intent Sale— 已授权并立即从客户帐户中收回购买金额。
-
设置 Button Color 以确定Google Pay按钮的颜色：
White或Black -
对于 Merchant ID，输入您的商家ID(由Google提供)。
-
对于 Accepted Cards，使用Google Pay选择客户可用于下订单的卡片类型。
选项：
Visa/MasterCard/AMEX/Discover/JCB -
对于 Sort Order，请输入数字以确定在结帐期间与其他付款选项一起列出Google Pay时显示的顺序。
步骤10：通过Braintree设置完成Venmo
-
要将Venmo作为付款选项包含在Braintree中，请将 Enable Venmo through Braintree 设置为
Yes。 -
将 Enable Vault for Venmo 设置为
Yes可允许使用安全保管库存储客户的Venmo帐户，这样客户就无需再次登录到其Venmo帐户即可进行将来交易。
-
将 Payment Action 设置为以下项之一：
Authorize Only— 批准购买并暂停资金。 在商户捕获 销售额 之前，不会从客户的银行帐户提取此金额。Intent Sale— 已授权并立即从客户帐户中收回购买金额。
-
对于 Sort Order，请输入一个数字以确定在结帐过程中与其他付款选项一起列出Venmo时显示的顺序。
步骤11：通过Braintree设置完成PayPal
通过Braintree设置
-
若要将PayPal作为付款选项包含在Braintree中，请将 Enable PayPal through Braintree 设置为
Yes。 -
通过Braintree付款方式指定您的PayPal：
note note NOTE 可以启用 PayPal Credit 或 PayPal PayLater。 无法同时启用这两种方法。 -
若要将PayPal Credit作为付款选项包含在Braintree中，请将 Enable PayPal Credit through Braintree 设置为
Yes。当 通过Braintree启用PayPal 设置为
Yes时，仅显示此字段。note note NOTE PayPal信用仅在美国和英国可用。 如果_Merchant Country_字段的选定值不是 US或UK，则PayPal点数已禁用。 -
若要将PayPal PayLater作为付款选项包含在Braintree中，请将 Enable PayPal PayLater through Braintree 设置为
Yes。当 Enable PayPal PayLater through Braintree 设置为
Yes时，仅出现此字段。您可以在您的网站上显示PayLater消息以提供各种优惠，例如 在3 内付款，客户可按月支付三笔免息款项。 Braintree集成可以在您的网站上显示消息以推广此功能。 您不能将PayLater选件与任何其他内容、营销或材料一起促销。
-
-
对于 Title，输入在结账期间通过PayPal选项标识Braintree付款的标题。
-
将 Vault Enabled 设置为
Yes以允许使用安全保管库存储客户的PayPal帐户。 保管式PayPal帐户可用于未来交易，从而减少客户的步骤数。 -
将 Send Cart Line Items for PayPal 设置为
Yes以将行项目（订单项目）与礼品卡、项目礼品包装、订单礼品包装、商店退款、配送和税作为行项目发送到PayPal。 -
对于 Sort Order，输入一个数字，以确定BraintreePayPal付款选项在结帐期间与其他付款选项一起列出时的显示顺序。
-
要以不同于存储配置中定义的形式显示商家名称，请在 Override Merchant Name 字段中输入您希望其显示的名称。
-
将 Payment Action 设置为以下项之一：
Authorize Only— 批准购买并暂停资金。 在商户捕获 销售额 之前，不会从客户的银行帐户提取此金额。Authorize and Capture— 已授权并立即从客户帐户中收回购买金额。
-
对于PayPal处理的Braintree事务，将 Payment from Applicable Countries 设置为以下项之一：
All Allowed Countries— 来自您商店配置中指定的所有国家/地区的客户都可以使用此付款方式。Specific Countries— 选择此选项后，将显示 Payment from Specific Countries 列表。 按住Ctrl键(PC)或Command键(Mac)，然后选择客户可在您的商店中购买产品的每个国家/地区。
-
若要要求客户提供帐单地址，请将 Require Customer’s Billing Address 设置为
Yes。note note NOTE 必须由PayPal技术支持为您的帐户启用此功能。 -
要保存通过Braintree存储存储区与PayPal之间交互的日志文件，请将 Debug 设置为
Yes。 -
要在迷你购物车和购物车页面上同时显示PayPal按钮，请将 Display on Shopping Cart 设置为
Yes。
步骤12：设置样式设置
-
对于 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 字段中选择的按钮类型而异。
-
要在所选位置的店面上显示PayPal按钮，请将 Show PayPal Button 设置为
Yes。 -
对于 Button Label，选择PayPal按钮标签：
Paypal、Checkout、Buynow或Pay -
对于 Color，选择PayPal按钮颜色：
Blue、Black、Gold或Silver -
对于 Shape，选择PayPal按钮形状：
Pill或Rectangle -
对于 Size (Deprecated)，选择PayPal按钮大小：
Medium、Large或Responsive
PayLater Messaging
-
要在所选位置的店面上显示PayLater消息，请将 Show PayLater Messaging 设置为
Yes。此消息包括显示可用优惠的PayLater消息（限制适用）。
-
对于 Message Layout，选择PayLater消息布局：
Text或Flex -
对于 Logo，选择PayPal徽标类型：
Inline、Primary、Alternative或None -
对于 Logo Position，选择PayPal徽标位置：
Left、Right或Top -
对于 Text Color，选择PayLater消息文本颜色：
Black、White、Monochrome或Grayscale
设置这些选项后，您可以看到PayPal按钮和PayLater消息的预览。 可以使用以下控件来应用设置或重置值：
-
要存储按钮和PayLater消息传递的选定样式设置并将它们应用到当前位置和当前按钮类型，请单击 Apply。
-
要存储按钮和PayLater消息值的选定样式设置并将它们应用于所有按钮类型和位置，请单击 Apply to All Buttons。
-
要将样式设置返回到按钮和PayLater消息传递的推荐默认值，并将它们应用于所有按钮类型和位置，请单击 Reset to Recommended Defaults。
步骤13：完成3D验证设置
-
如果要为使用已注册验证计划（如 由VISA验证）的信用卡的客户添加验证步骤，请将 3D Secure Verification 设置为
Yes。在此过程中，提交进行核实的交易金额会与发送进行授权的金额进行核对。
-
若要始终质询所有事务的3D安全请求，请将 Always request 3DS 设置为
Yes。 -
对于 Threshold Amount，输入触发3D验证所需的最小订单金额。
-
将 Verify for Applicable Countries 设置为以下项之一：
All Allowed Countries— 来自您商店配置中指定的所有国家/地区的客户都可以使用此付款方式。Specific Countries— 选择此选项后，将显示 Verify for Specific Countries 列表。 按住Ctrl键(PC)或Command键(Mac)，然后选择客户可在您的商店中购买产品的每个国家/地区。
步骤14：设置Braintree动态描述符
以下描述符用于识别客户信用卡对账单上的购买情况。 您可以通过明确识别与每次购买关联的公司来减少回扣次数。 如果没有为您的帐户启用动态描述符，请联系Braintree支持部门。
-
根据以下准则输入 Name、Phone 和 URL 的动态描述符：
-
Name — 名称描述符由两部分组成，它们之间用星号(*)分隔。 例如：
company*myproduct描述符的第一部分标识公司或DBA，第二部分标识产品。 描述符的
company和product部分的长度可以通过以下方式进行分配，组合长度最多为22个字符。名称描述符中有 个字符
选项1：
Company必须为三个字符，Product最多可包含18个字符选项2：
Company必须为7个字符，Product最多可包含14个字符选项3：
Company必须为12个字符，Product最多可为9个字符 -
Phone — 电话描述符的长度必须为10 - 14个字符，并且只能包含数字、破折号、圆括号和句点。 例如：
9999999999(999) 999-9999999.999.9999 -
URL - URL描述符表示您的域名，最长可为13个字符。 例如：
company.com
-
-
Braintree配置完成后，单击 Save Config。
2.4升级说明
从Adobe Commerce和Magento Open Source2.4.0开始，此版本中包含了Braintree扩展。 如果您从安装了MarketplaceBraintree扩展的2.4.0之前的版本迁移到Commerce 2.4.x，则必须卸载该扩展（paypal/module-braintree或gene/module-braintree），并更新任何代码自定义以使用PayPal_Braintree命名空间而不是Magento_Braintree。 核心CommerceBraintree支付捆绑扩展和分发到Commerce Marketplace的扩展中的配置设置将保留，并且仍可以正常捕获、撤消或退款与这些先前版本一起进行的支付。