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時,商家需要解除安裝散佈於市集(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,您的商家識別碼在生產與沙箱閘道上不同。 當​ Environment ​欄位設為Sandbox時,會顯示此欄位。
Sandbox Public Key
存放區檢視
這是您的使用者專屬公用識別碼,可限制對加密資料的存取。 與您的沙箱Braintree閘道關聯的每個使用者都有各自的沙箱公開金鑰。 當​ Environment ​欄位設為Sandbox時,會顯示此欄位。
Sandbox Private Key
存放區檢視
這是您的使用者專屬私人識別碼,可限制對加密資料的存取。 與您的沙箱Braintree閘道關聯的每個使用者都有各自的沙箱私密金鑰。 當​ Environment ​欄位設為Sandbox時,會顯示此欄位。
Merchant 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新增至您的Braintree帳戶,做為Webhook Destination URL。 此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](./assets/payment-methods-braintree-ach-config.png)進行![ACH

欄位
領域
說明
Enabled ACH Direct Debit
網站
決定是否要透過Braintree將ACH Direct Debit納入為付款方式。 選項: 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授權並擷取,且訂單與發票會在您的商店管理員中建立。 注意: ​在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和更早版本中的​ 授權和擷取
Sort Order
網站
決定結帳期間Venmo與其他付款方法一起列出的順序。

PayPal through Braintree

透過BraintreePayPal

欄位
領域
說明
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