Sales > Payment Methods > Braintree

IMPORTANT
Commerce 2.4移轉:

若是2.4.0之前的Adobe Commerce和Magento Open Source版本,建議商家從以下網址安裝並設定官方Braintree支付整合擴充功能: Commerce Marketplace 以取代核心整合。 截至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擴充功能,則Braintree 2.4.0版無法運用多位址功能。 當購物者選取 傳遞至多個地址 ,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進階設定 {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
網站
防止將交易當作的一部分傳送以進行評估 Advanced Fraud Tools 核取,僅在透過管理員下單的訂單上設定為 Yes.
選項: 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 (或 Command (在Mac上)以選取卡片組合。 選項: 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新增至您的Braintree帳戶,做為 Webhook Destination URL. 此URL必須是安全的並可公開存取。
Fraud Protection Approve Order Status
網站
當Braintree核准防詐騙功能時,系統會將選取的訂單狀態指派給商務訂單。 此狀態是用來更新使用ACH付款方式的訂單狀態以及訂單移至 SETTLED 在Braintree中。
Fraud Protection Reject Order Status
網站
當Braintree拒絕詐騙保護時,會將選取的訂單狀態指派給商務訂單。 此狀態是用來更新使用ACH付款方式的訂單狀態,以及當 SETTLEMENTDECLINED 在Braintree中。

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透過Braintree

欄位
範圍
說明
Enabled ACH Direct Debit
網站
決定是否 ACH Direct Debit 是透過Braintree以付款方式納入。 選項: Yes / No
Enable Vault for ACH Direct Debit
網站
客戶可以儲存/儲存單次使用的ACH Direct Debit支付方式,以供日後使用。 一旦付款明細存入儲存庫,客戶就可以使用ACH Direct Debit付款方式,無需重新輸入資料或重新驗證其付款資訊。 選項: 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授權並擷取,而訂單與商業發票則建立於您的商店管理員中。 注意: 這是 Authorize and Capture (在2.3.x及舊版中)。
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
網站
決定是否 Google Pay 透過Braintree以付款方式包含付款。 選項: Yes / No
Enable Vault for GooglePay
網站
客戶可以儲存/儲存其Google Pay付款方式,以供日後使用。 一旦付款詳細資料存入儲存庫,客戶就可以使用Google Pay,無需重新輸入資料或重新驗證其付款資訊。 選項: Yes / No
Payment Action
網站
決定Braintree在處理付款時所採取的動作。 選項:
Authorize— 客戶卡上的資金已獲授權,但並未從客戶帳戶轉帳。 系統會在您的商店管理員中建立訂單。 您稍後可以擷取銷售,並建立發票。
Intent Sale — 客戶卡上的資金由Braintree授權並擷取,而訂單與商業發票則建立於您的商店管理員中。 注意: 這是 Authorize and Capture (在2.3.x及舊版中)。
Button Color
網站
決定 Google Pay 按鈕。 選項: White / Black
Merchant ID
存放區檢視
必須在這裡輸入Google提供的ID。
Accepted Cards
網站
選擇客戶可使用以下方式下訂單的卡片型別 Google Pay.
Sort Order
網站
決定結帳期間Google Pay與其他付款方法一起列出的順序。

Venmo through Braintree

Venmo透過Braintree

欄位
範圍
說明
Enable Venmo through Braintree
網站
決定是否 Venmo 是透過Braintree以付款方式納入。 選項: Yes / No
Enable Vault for Venmo
網站
客戶可以儲存/儲存他們的Venmo付款方式,以供日後使用。 一旦付款明細存入儲存庫,客戶就可以使用「Venmo」付款方式,而不需重新輸入資料或重新驗證其付款資訊。 選項: Yes / No
Payment Action
網站
決定Braintree在處理付款時所採取的動作。 選項:
Authorize— 客戶卡上的資金已獲授權,但並未從客戶帳戶轉帳。 系統會在您的商店管理員中建立訂單。 您稍後可以擷取銷售,並建立發票。
Intent Sale — 客戶卡上的資金由Braintree授權並擷取,而訂單與商業發票則建立於您的商店管理員中。 注意: 這是 授權與擷取 (在2.3.x及舊版中)。
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 CreditPayPal 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— 公司必須為三個字元/產品最多可為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