Braintree

Braintree提供完全可自訂的結帳體驗,包含詐騙偵測和PayPal整合。 它支援 Apple Pay, Google Pay、ACH、Venmo和本地支付方式。 Braintree可減輕商戶的PCI法規遵循負擔,因為交易是在Braintree系統上進行。 「Braintree付款」整合的開發者為 GENE Commerce.

NOTE
如果您要從舊版Adobe Commerce升級至2.4.x,或安裝了來自Magento Open Source的Braintree擴充功能的Commerce Marketplace,請參閱 2.4升級注意事項 在本頁結尾處。

步驟1:取得您的Braintree認證

前往 Braintree付款 並註冊帳戶。

步驟2:完成基本設定

  1. 管理員 側欄,前往 Stores > Settings>Configuration.

  2. 在左側面板中,展開 Sales 並選擇 Payment Methods.

    • 如果您的Commerce安裝有多個網站、商店或檢視,請在左上角選擇 Store View 組態適用的位置。

    • Merchant Location ​區段,確認​ Merchant Country ​設為企業的所在位置。

  3. Recommended Solutions,在_Braintree Payments (作者: GENE Commerce v4.6.1 - 發行說明_區段,按一下​ Configure.

    設定Braintree {width="600" modal="regular"}

  4. Title,輸入在結帳時將Braintree識別為付款選項的標題。

  5. 設定目前的作業中 Environment 用於Braintree交易至 SandboxProduction

    在沙箱中測試設定時,僅使用 信用卡號碼 由Braintree建議。 當您準備好透過Braintree前往生產時,請設定 EnvironmentProduction.

    基本認證設定 {width="600" modal="regular"}

  6. 設定 Payment Action 變更為下列其中一項:

    • Authorize Only — 核准購買並保留資金。 在銷售完成之前,不會從客戶的銀行帳戶提取金額 已擷取 由商家提供。|
    • Intent Sale — 採購金額已獲授權,並立即從客戶帳戶中提取。 注意: 此值是 授權與擷取 (在2.3.x及舊版中)。|
  7. 輸入 Sandbox Merchant ID / Merchant ID 從您的Braintree帳戶。

  8. 從您的Braintree帳戶輸入下列認證:

    • Sandbox Public Key / Public Key
    • Sandbox Private Key / Private Key
    note note
    NOTE
    兩者都有個別欄位 (沙箱和生產) 環境和其他欄位會根據選取的環境進行轉譯。
  9. 在儲存設定之前,按一下 Validate Credentials 以驗證您的認證。

  10. 設定 Enable Card PaymentsYes.

    基本設定 {width="600" modal="regular"}

    如果您想要能夠安全地儲存客戶資訊,以便客戶不需要在每次購買時都重新輸入,請設定 Enable Vault for Card PaymentsYes.

步驟3:完成進階設定

  1. 展開 展開選擇器 Advanced Braintree Settings 區段。

    進階設定 {width="550" modal="regular"}

  2. Vault Title,輸入描述性標題供您參考,以識別儲存客戶卡資訊的儲存庫。

  3. 輸入 Merchant Account ID 從您的Braintree帳戶。

    如果您未指定要使用的貿易商科目,則Braintree會使用您的預設貿易商科目來處理交易。

  4. 為了在結帳程式開始時使用「快速付款」選項(包括PayPal、PayLater、Apple Pay和Google Pay)提供更快速的結帳體驗,請設定 Enable Checkout Express PaymentsYes.

  5. 如果您要防止在進階詐騙工具檢查時傳送交易以進行評估,請透過管理員下達的訂單上設定 Skip Fraud Checks on Admin OrdersYes.

  6. 設定 Bypass Fraud Protection Threshold 如此 Advanced Fraud Protection 當達到或超過臨界值時,會略過檢查。

    將此欄位保留空白會停用此選項。

  7. 如果您希望系統儲存存放區與Braintree之間互動的記錄檔,請設定 DebugYes.

  8. 若要要求客戶從信用卡背面提供三位數的安全代碼,請設定 CVV VerificationYes.

    如果使用CVV驗證,請務必在「 」中啟用AVS和/或CVV 設定/處理 Braintree部分。

  9. 若要針對所有付款方式傳送購物車明細專案,請設定 Send Card Line ItemsYes.

  10. Credit Card Types,選取您的商店接受以透過Braintree付款的每個信用卡。

    若要選取多種卡片型別,請按住Ctrl鍵(PC)或Command鍵(Mac)並按一下每個選項。

  11. Sort Order,請輸入數字,以決定結帳期間與其他付款方法一起列出Braintree時的顯示順序。

步驟4:完成Braintreewebhook設定

BraintreeWebhook設定 {width="600" modal="regular"}

  1. 設定 Enable WebhookYes 啟用webhook功能以防範詐騙、ACH付款及本機付款方法。

  2. 將URL複製到 Fraud Protection URL 欄位並將其新增到您的Braintree帳戶,作為 Webhook Destination URL.

    note important
    IMPORTANT
    此URL必須是安全的並可公開存取。
  3. 設定 Fraud Protection Approve Order Status 用於判斷Braintree何時核准詐騙保護的欄位。

    選取的訂單狀態會指派給商務訂單。

  4. 設定 Fraud Protection Reject Order Status 用於判斷Braintree何時拒絕詐騙保護的欄位。

    選取的訂單狀態會指派給商務訂單。

步驟5:完成國家/地區專屬設定

  1. 設定 Payment from Applicable Countries 變更為下列其中一項:

    • All Allowed Countries — 來自所有客戶的客戶 國家/地區 在商店設定中指定的可使用此付款方式。
    • Specific Countries — 選擇此選項後, Payment from Specific Countries ​清單隨即顯示。 按住Ctrl鍵(PC)或Command鍵(Mac),並在清單中選取客戶可在您的商店購買產品的國家/地區。

    國家/地區特定設定 {width="600" modal="regular"}

  2. 若要設定 Country Specific Credit Card Types

    • 按一下 Add.

    • 設定 Country 並選擇每個 Allowed Credit Card Type.

    • 重複此步驟以識別每個國家/地區接受的信用卡。

步驟6:透過Braintree設定完成ACH

ACH透過Braintree {width="600" modal="regular"}

  1. 若要將ACH納入為Braintree的付款選項,請設定 Enable ACH Direct DebitYes.

  2. 客戶可儲存其單次使用的ACH Direct Debit支付方式,並將其儲存以供日後使用。 一旦儲存起來,客戶就可以重複使用ACH Direct Debit直接扣款,不需要重新輸入或驗證其付款資訊(若已設定) Enable Vault for ACH Direct DebitYes.

  3. Sort Order,請輸入數字,以決定結帳期間與其他付款選項一起列出時,BraintreeACH付款選項出現的順序。

步驟7:完成 Apple Pay 透過Braintree設定

透過Braintree設定的ApplePay {width="600" modal="regular"}

  1. 要包含 Apple Pay 作為Braintree的付款選項,請設定 Enable ApplePay through BraintreeYes.

    確定 驗證您的網域名稱 在您的Braintree帳戶中。

  2. 如果您想要能夠安全地儲存客戶資訊,以便客戶每次使用Apple Pay購買時都不需要重新輸入,請設定 Enable Vault for ApplePayYes.

  3. 設定 Payment Action 變更為下列其中一項:

    • Authorize Only — 核准購買並保留資金。 在銷售完成之前,不會從客戶的銀行帳戶提取金額 已擷取 由商家提供。
    • Intent Sale — 採購金額已獲授權,並立即從客戶帳戶中提取。
  4. Merchant Name,輸入文字,指定在Apple支付對話方塊中向客戶顯示的標籤。

  5. Sort Order,請輸入數字以決定順序 Apple Pay 在結帳期間與其他付款選項一起列出時,會顯示付款選項。

步驟8:完成本機付款方式的設定

  1. 若要將當地付款方式納入為Braintree的付款選項,請設定 Enable Local Payment MethodsYes.

  2. Title,輸入用於顯示在「結帳付款方式」區段上的標籤的文字(預設值: Local Payments)。

  3. Fallback Button Text,輸入用於後援Braintree頁面上顯示的按鈕的文字,以將客戶帶回網站(例如, Complete Checkout)。

  4. Redirect on Fail,輸入當本機付款方式交易取消、失敗或發生錯誤時,應重新導向客戶的URL。 它應該是結帳付款頁面(例如, https://www.domain.com/checkout#payment)。

  5. Allowed Payment Methods,選取要啟用的本機付款方式。

    選項: Bancontact / EPS / giropay / iDeal / Klarna Pay Now / SOFORT / MyBank / P24 / SEPA/ELV Direct Debit (尚未支援)

    本機付款方式設定 {width="600" modal="regular"}

    note note
    NOTE
    套件式Braintree擴充功能不支援 Braintree開發人員檔案. 正在開發其他本機付款方法,未來版本將支援這些方法。
  6. Sort Order,請輸入數字,以決定結帳期間與其他付款選項一起列出時本機付款方式出現的順序。

步驟9:完成 Google Pay 透過Braintree設定

Google透過Braintree支付 {width="600" modal="regular"}

  1. 要包含 Google Pay 作為Braintree的付款選項,請設定 Enable GooglePay Through BraintreeYes.

  2. 如果您想要能夠安全地儲存客戶資訊,以便客戶每次使用Google Pay購買時都不需要重新輸入,請設定 Enable Vault for GooglePayYes.

  3. 設定 Payment Action 變更為下列其中一項:

    • Authorize Only — 核准購買並保留資金。 在銷售完成之前,不會從客戶的銀行帳戶提取金額 已擷取 由商家提供。
    • Intent Sale — 採購金額已獲授權,並立即從客戶帳戶中提取。
  4. 設定 Button Color 以決定 Google Pay 按鈕: WhiteBlack

  5. Merchant ID,輸入您的MerchantID (由Google提供)。

  6. Accepted Cards,選取客戶可使用來下訂單的卡片型別 Google Pay.

    選項: Visa / MasterCard / AMEX / Discover / JCB

  7. Sort Order,請輸入數字以決定順序 Google Pay 在結帳期間與其他付款選項一起列出時出現。

步驟10:透過Braintree設定完成Venmo

  1. 若要包含Venmo作為Braintree的付款選項,請設定 Enable Venmo through BraintreeYes.

  2. 設定 Enable Vault for VenmoYes 啟用安全儲存庫來儲存客戶的Venmo帳戶,這樣客戶就不需要再次登入其Venmo帳戶即可進行未來的交易。

    Venmo透過Braintree {width="600" modal="regular"}

  3. 設定 Payment Action 變更為下列其中一項:

    • Authorize Only — 核准購買並保留資金。 在銷售完成之前,不會從客戶的銀行帳戶提取金額 已擷取 由商家提供。
    • Intent Sale — 採購金額已獲授權,並立即從客戶帳戶中提取。
  4. Sort Order,請輸入數字,以決定結帳期間Venmo與其他付款選項一起列出時的顯示順序。

步驟11:透過Braintree設定完成PayPal

透過Braintree設定的PayPal {width="550" modal="regular"}

  1. 若要包含PayPal作為Braintree的付款選項,請設定 Enable PayPal through BraintreeYes.

  2. 透過Braintree付款方式指定您的PayPal:

    note note
    NOTE
    兩者之一 PayPal CreditPayPal PayLater 可以啟用。 無法同時啟用這兩種方法。
    • 要包含 PayPal Credit 作為Braintree的付款選項,請設定 Enable PayPal Credit through BraintreeYes.

      時間 透過Braintree啟用PayPal 設為 Yes,則只會顯示此欄位。

      note note
      NOTE
      PayPal信用僅在美國及英國提供。 如果為以下專案選取的值,則會停用PayPal點數 Merchant Country ​欄位不是 USUK.
    • 要包含 PayPal PayLater 作為Braintree的付款選項,請設定 Enable PayPal PayLater through BraintreeYes.

      時間 Enable PayPal PayLater through Braintree 設為 Yes,則只會顯示此欄位。

      您可以在您的網站上顯示優惠的PayLater訊息,例如 付款單位3,客戶可每月以三筆免息款項付款。 Braintree整合可在您的網站上顯示訊息,以推廣此功能。 您無法將PayLater優惠方案與任何其他內容、行銷或資料一起促銷。

  3. Title,輸入標題,以在結帳時識別透過PayPal選項的Braintree付款。

  4. 設定 Vault EnabledYes 以使用安全儲存庫來儲存客戶的PayPal帳戶。 存放的PayPal帳戶可用於未來的交易,減少客戶的步驟數。

  5. 設定 Send Cart Line Items for PayPalYes 將明細專案(訂購專案)連同禮品卡、專案禮品包裝、訂購禮品包裝、商店退款、送貨和稅捐一起傳送至PayPal。

  6. Sort Order,請輸入數字,以決定結帳期間BraintreePayPal付款選項與其他付款選項一起列出時的顯示順序。

  7. 若要以不同於中定義的方式顯示您的商家名稱,請執行下列步驟: 存放區設定,請在 Override Merchant Name 欄位顯示的方式。

  8. 設定 Payment Action 變更為下列其中一項:

    • Authorize Only — 核准購買並保留資金。 在銷售完成之前,不會從客戶的銀行帳戶提取金額 已擷取 由商家提供。
    • Authorize and Capture — 採購金額已獲授權,並立即從客戶帳戶中提取。
  9. 設定 Payment from Applicable Countries 針對PayPal所處理的Braintree交易,變更為下列其中一項:

    • All Allowed Countries — 來自所有客戶的客戶 國家/地區 在商店設定中指定的可使用此付款方式。
    • Specific Countries — 選擇此選項後, Payment from Specific Countries ​清單隨即顯示。 按住Ctrl鍵(PC)或Command鍵(Mac),並在清單中選取客戶可在您的商店購買產品的國家/地區。
  10. 若要要求客戶提供帳單地址,請設定 Require Customer’s Billing AddressYes.

    note note
    NOTE
    您的帳戶必須由PayPal技術支援啟用此功能。
  11. 若要透過Braintree儲存商店與PayPal之間互動的記錄檔,請設定 DebugYes.

  12. 若要在迷你購物車和購物車頁面上顯示PayPal按鈕,請設定 Display on Shopping CartYes.

步驟12:設定樣式設定

  1. Location,選擇轉譯PayPal按鈕和訊息的位置: Mini-Cart and Cart PageCheckout Page,或 Product Page

    PayPal樣式設定 {width="600" modal="regular"}

Mini-Cart and Cart Page

本節中的選項和設定會因 Location ​欄位。

  1. 設定 PayPal Button Type 三種按鈕型別之一: PayPal Button / PayPal Pay Later Button / PayPal Credit Button

PayPal Button

本節中的選項和設定會因在中選取的按鈕型別而異。 PayPal Button Type ​欄位。

  1. 若要在選取位置的店面上顯示PayPal按鈕,請設定 Show PayPal ButtonYes.

  2. Button Label,選取PayPal按鈕標籤: PaypalCheckoutBuynow,或 Pay

  3. Color,選取PayPal按鈕色彩: BlueBlackGold,或 Silver

  4. Shape,選取PayPal按鈕形狀: PillRectangle

  5. Size (Deprecated),選取PayPal按鈕大小: MediumLarge,或 Responsive

NOTE
Size(Deprecated) 設定欄位已過時,不用於設定PayPal按鈕的樣式。

PayLater Messaging

  1. 顯示 PayLater 在選取位置的店面傳訊,設定 Show PayLater MessagingYes.

    此傳訊功能會顯示 PayLater 傳送訊息給可用的優惠方案(限制套用)。

  2. Message Layout,選取 PayLater 訊息配置: TextFlex

  3. Logo,選取PayPal標誌型別: InlinePrimaryAlternative,或 None

  4. Logo Position,選取PayPal標誌位置: LeftRight,或 Top

  5. Text Color,選取 PayLater 訊息文字色彩: BlackWhiteMonochrome,或 Grayscale

設定這些選項後,您可以看到PayPal按鈕和PayLater訊息的預覽。 有些控制項可用來套用設定或重設值:

  • 若要儲存按鈕和PayLater訊息的選取樣式設定,並將它們套用至目前位置和目前的按鈕型別,請按一下 Apply.

  • 若要儲存按鈕和PayLater訊息值的選取樣式設定,並將它們套用至所有按鈕型別和位置,請按一下 Apply to All Buttons.

  • 若要將樣式設定恢復為按鈕和PayLater訊息的建議預設值,並將其套用至所有按鈕型別和位置,請按一下 Reset to Recommended Defaults.

步驟13:完成3D驗證設定

  1. 如果您要為使用已註冊驗證方案(例如 由VISA驗證),設定 3D Secure VerificationYes.

    在處理期間,會針對送出進行授權的金額,檢查送出進行驗證的交易金額。

  2. 若要一律對所有交易挑戰3D Secure要求,請設定 Always request 3DSYes.

  3. Threshold Amount,請輸入觸發3D驗證所需的最小訂購量。

  4. 設定 Verify for Applicable Countries 變更為下列其中一項:

    • All Allowed Countries — 來自所有客戶的客戶 國家/地區 在商店設定中指定的可使用此付款方式。
    • Specific Countries — 選擇此選項後, Verify for Specific Countries ​清單隨即顯示。 按住Ctrl鍵(PC)或Command鍵(Mac),並在清單中選取客戶可在您的商店購買產品的國家/地區。

    3D驗證設定 {width="600" modal="regular"}

步驟14:設定Braintree動態描述元

以下描述元可用來識別客戶信用卡對帳單上的購買專案。 您可以明確識別與每次購買相關聯的公司,以減少費用回傳次數。 如果您的帳戶未啟用動態描述元,請聯絡Braintree支援。

動態描述元 {width="600" modal="regular"}

  1. 輸入以下專案的動態描述項: NamePhone、和 URL 根據以下准則:

    • Name — 名稱描述項分為兩部分,以星號(*)分隔。 例如:

      company*myproduct

      描述項的第一部分可識別公司或DBA,第二部分則可識別產品。 的長度 companyproduct 部分描述項可以透過以下方式配置,合併長度最多為22個字元。

      名稱描述項中的字元

      選項1: Company 必須為三個字元, Product 最多可包含18個字元

      選項2: Company 必須為七個字元, Product 最多可包含14個字元

      選項3Company 必須為12個字元, Product 最多可包含9個字元

    • Phone — 電話描述元的長度必須是10到14個字元,而且只能包含數字、破折號、括弧和句點。 例如:

      9999999999

      (999) 999-9999

      999.999.9999

    • URL - URL描述項代表您的網域名稱,長度最多為13個字元。 例如:

      company.com

  2. 當您的Braintree設定完成後,按一下 Save Config.

2.4升級注意事項

從Adobe Commerce和Magento Open Source2.4.0開始,Braintree擴充功能已包含在發行版本中。 如果您要從已安裝MarketplaceBraintree擴充功能的2.4.0之前版本移轉至Commerce 2.4.x,您必須解除安裝該擴充功能(paypal/module-braintreegene/module-braintree)並更新任何程式碼自訂,以使用 PayPal_Braintree 名稱空間而非 Magento_Braintree. 來自核心「商務Braintree付款」套件擴充功能的組態設定以及在Commerce Marketplace上散佈的擴充功能會持續存在,而且仍可正常擷取、作廢或退款這些舊版本的付款。

recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1