Braintree

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

NOTE
如果您要從舊版Adobe Commerce升級至2.4.x,或使用Commerce Marketplace安裝的Braintree擴充功能升級至Magento Open Source,請參閱本頁結尾的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. 將Braintree交易的目前作業​ Environment ​設定為SandboxProduction

    在沙箱中測試設定時,僅使用Braintree建議的信用卡號碼。 當您準備使用Braintree前往生產時,請將​ Environment ​設為Production

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

  6. 將​ Payment Action ​設定為下列其中一項:

    • Authorize Only — 核准購買並保留資金。 在銷售由商家擷取​__​之前,不會從客戶的銀行帳戶提取金額。|
    • Intent Sale — 已授權並立即從客戶帳戶中取用購買的金額。 注意: ​在2.3.x和更舊版本中,這個值為​ Authorize and Capture。|
  7. 輸入您Braintree帳戶中的​ Sandbox Merchant ID / Merchant ID

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

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

  10. 將​ Enable Card Payments ​設為Yes

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

    如果您想要能夠安全地儲存客戶資訊,讓客戶不必在每次購買時都重新輸入,請將​ Enable Vault for Card Payments ​設為Yes

步驟3:完成進階設定

  1. 展開​ Advanced Braintree Settings ​區段的 擴充選擇器

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

  2. 針對​ Vault Title,輸入描述性標題作為參考,以識別儲存客戶卡資訊的儲存庫。

  3. 輸入您Braintree帳戶中的​ Merchant Account ID

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

  4. 若要在結帳程式開始時使用「快速付款」選項(包括PayPal、PayLater、Apple Pay及Google Pay)提供更快速的結帳體驗,請將​ Enable Checkout Express Payments ​設為Yes

  5. 如果您要防止在進階詐騙工具檢查期間傳送交易以進行評估,請透過管理員下單,將​ Skip Fraud Checks on Admin Orders ​設為Yes

  6. 設定​ Bypass Fraud Protection Threshold,以便在達到或超過臨界值時略過Advanced Fraud Protection檢查。

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

  7. 如果您希望系統儲儲存儲存存存放區與Braintree間互動的記錄檔,請將​ Debug ​設為Yes

  8. 若要要求客戶從信用卡背面提供三位數的安全碼,請將​ CVV Verification ​設為Yes

    如果使用CVV驗證,請確定在您Braintree帳戶的​ 設定/處理 ​區段中啟用AVS和/或CVV。

  9. 若要針對所有付款方式傳送購物車明細專案,請將​ Send Card Line Items ​設為Yes

  10. 針對​ Credit Card Types,選取商店接受的每張信用卡透過Braintree付款。

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

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

步驟4:完成Braintreewebhook設定

BraintreeWebhook設定

  1. 將​ Enable Webhook ​設為Yes以啟用webhook功能以進行詐騙保護、ACH付款和本機付款方法。

  2. 複製​ Fraud Protection URL ​欄位中的URL並將其新增至您的Braintree帳戶做為​ Webhook Destination URL

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

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

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

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

步驟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

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

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

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

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

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

透過Braintree設定的ApplePay

  1. 若要包含Apple Pay作為Braintree的付款選項,請將​ Enable ApplePay through Braintree ​設為Yes

    請務必先在您的Braintree帳戶中驗證您的網域名稱

  2. 如果您想要能夠安全地儲存客戶資訊,以便客戶每次透過Apple Pay購買時都不需要重新輸入,請將​ Enable Vault for ApplePay ​設為Yes

  3. 將​ Payment Action ​設定為下列其中一項:

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

  5. 針對​ Sort Order,輸入數字以決定結帳期間與其他付款選項一起列出時,Apple Pay付款選項出現的順序。

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

  1. 若要將本機付款方式納入為Braintree的付款選項,請將​ Enable Local Payment Methods ​設為Yes

  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:透過Braintree設定完成Google Pay

Google透過Braintree付款

  1. 若要包含Google Pay作為Braintree的付款選項,請將​ Enable GooglePay Through Braintree ​設為Yes

  2. 如果您想要能夠安全地儲存客戶資訊,以便客戶每次透過Google Pay購買時都不需要重新輸入,請將​ Enable Vault for GooglePay ​設為Yes

  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 Braintree ​設為Yes

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

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

  3. 將​ Payment Action ​設定為下列其中一項:

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

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

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

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

  2. 透過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_​欄位的選取值不是USUK,則PayPal點數已停用。
    • 若要包含PayPal PayLater作為Braintree的付款選項,請將​ Enable PayPal PayLater through Braintree ​設為Yes

      當​ Enable PayPal PayLater through Braintree ​設定為Yes時,只會出現此欄位。

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

  3. 針對​ Title,輸入標題以識別結帳期間透過PayPal選項的Braintree付款。

  4. 將​ Vault Enabled ​設為Yes以啟用安全儲存庫來儲存客戶的PayPal帳戶。 存放的PayPal帳戶可用於未來的交易,減少客戶的步驟數。

  5. 將​ Send Cart Line Items for PayPal ​設為Yes,將明細專案(訂單專案)連同禮品卡、專案禮品包裝、訂單禮品包裝、商店退款、送貨及稅捐一併傳送至PayPal。

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

  7. 若要以不同於存放區組態中定義的方式顯示您的商家名稱,請在​ Override Merchant Name ​欄位中輸入您想要顯示的名稱。

  8. 將​ Payment Action ​設定為下列其中一項:

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

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

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

  12. 若要在迷你購物車和購物車頁面上顯示PayPal按鈕,請將​ Display on Shopping Cart ​設為Yes

步驟12:設定樣式設定

  1. 針對​ Location,選擇轉譯PayPal按鈕和訊息的位置: Mini-Cart and Cart PageCheckout PageProduct 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 Button ​設為Yes

  2. 針對​ Button Label,選取PayPal按鈕標籤: PaypalCheckoutBuynowPay

  3. 針對​ Color,選取PayPal按鈕色彩: BlueBlackGoldSilver

  4. 針對​ Shape,選取PayPal按鈕圖形: PillRectangle

  5. 針對​ Size (Deprecated),選取PayPal按鈕大小: MediumLargeResponsive

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

PayLater Messaging

  1. 若要在選取位置的店面顯示PayLater訊息,請將​ Show PayLater Messaging ​設為Yes

    此傳訊功能包括顯示可用優惠的PayLater傳訊(套用限制)。

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

  3. 針對​ Logo,選取PayPal標誌型別: InlinePrimaryAlternativeNone

  4. 針對​ Logo Position,選取PayPal標誌位置: LeftRightTop

  5. 針對​ Text Color,選取PayLater訊息文字色彩: BlackWhiteMonochromeGrayscale

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

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

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

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

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

  1. 如果您想要為使用已註冊驗證計畫(例如​ 由VISA驗證)之信用卡的客戶新增驗證步驟,請將​ 3D Secure Verification ​設為Yes

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

  2. 若要一律對所有交易挑戰3D Secure要求,請將​ Always request 3DS ​設為Yes

  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支援。

動態描述元

  1. 依照下列准則,輸入​ NamePhone ​和​ URL ​的動態描述項:

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

      company*myproduct

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

      名稱描述項中有​ 個字元

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

      選項2: Company必須是7個字元,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擴充功能已包含在發行版本中。 如果您要從2.4.0之前的版本移轉至Commerce 2.4.x (已安裝MarketplaceBraintree擴充功能),您必須解除安裝該擴充功能(paypal/module-braintreegene/module-braintree),並更新任何程式碼自訂,以使用PayPal_Braintree名稱空間而非Magento_Braintree。 來自核心「CommerceBraintree付款」套件擴充功能的組態設定以及在Commerce Marketplace上散佈的擴充功能會持續存在,而且仍可正常擷取、作廢或退款這些舊版本的付款。

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