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時,商家需要解除安裝散佈於市集(
如果您要升級至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時,商家需要解除安裝散佈於市集(
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,您的商家識別碼在生產與沙箱閘道上不同。 當 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
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新增至您的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
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
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和更早版本中的 授權和擷取。Sort Order
網站
決定結帳期間Venmo與其他付款方法一起列出的順序。
PayPal through Braintree
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