[PaaSのみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト(Adobeで管理されるPaaS インフラストラクチャ)とオンプレミス プロジェクトにのみ適用されます。"}

Braintree

IMPORTANT
カードの予期しない請求に関するサポートが必要な場合は、​ サブスクリプションの解約 ページにアクセスしてサポートを受けてください。

Braintreeでは、不正行為の検出とPayPalとの統合により、詳細にカスタマイズ可能なチェックアウト体験を提供します。 Apple Pay、Google Pay、ACH、Venmo、およびローカルの支払い方法をサポートしています。 Braintreeは、Braintreeシステムで取引がおこなわれるため、加盟店におけるPCI認定の負担を軽減することができます。 Braintree Payments統合は、GENE Commerceによって開発されました。

NOTE
Commerce MarketplaceのBraintree拡張機能がインストールされている以前のバージョンのAdobe CommerceまたはMagento Open Sourceから2.4.xにアップグレードする場合は、このページの最後にある2.4 アップグレードノート ​を参照してください。

手順1:Braintree資格情報の取得

Braintree支払いに移動し、アカウントにサインアップします。

手順2:基本設定を完了する

  1. 管理者 サイドバーで、Stores > Settings>Configuration​に移動します。

  2. 左側のパネルで、Sales​を展開し、Payment Methods​を選択します。

    • Commerce インストールに複数のweb サイト、ストア、またはビューがある場合、左上隅で、設定が適用される​ Store View ​を選択します。

    • Merchant Location」セクションで、Merchant Country​がビジネスの場所に設定されていることを確認します。

  3. Recommended Solutions​の下の「Braintree Payments」(GENE Commerce v4.7.0~​ リリースノート ​)セクションで、「Configure」をクリックします。

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

  4. Title​に、チェックアウト時の支払い方法としてBraintreeを特定するタイトルを入力します。

  5. Braintree トランザクションの現在のオペレーティング Environment​をSandboxまたはProductionに設定します

    サンドボックスで設定をテストする場合は、Braintreeが推奨する​ クレジットカード番号のみを使用します。 Braintreeを使用して本番環境に移行する準備ができたら、Environment​をProductionに設定します。

    基本資格情報の設定 {width="600" modal="regular"}

  6. Payment Action​を次のいずれかに設定します:

    • Authorize Only – 購入を承認し、資金を保留します。 金額は、販売者が販売を​ 獲得 ​するまで、顧客の銀行口座から引き出されません。|
    • Intent Sale – 購入金額が承認され、お客様のアカウントから直ちに引き落とされます。 Note:​この値は、2.3.x以前のリリースの_​認証とキャプチャ _でした。|
  7. Braintree アカウントから​ Sandbox Merchant ID / Merchant ID ​を入力します。

  8. Braintree アカウントから次の資格情報を入力します。

    • Sandbox Public Key / Public Key
    • Sandbox Private Key / Private Key
    note
    NOTE
    (サンドボックスおよび実稼動環境)​環境には個別のフィールドがあり、その他のフィールドは、選択されている環境に基づいてレンダリングされます。
  9. 設定を保存する前に、Validate Credentials​をクリックして資格情報を検証します。

  10. Enable Card Payments​をYesに設定します。

  11. 顧客の情報を安全に保存する機能を使用して、顧客が購入するたびに再入力する必要がない場合は、Enable Vault for Card Payments​をYesに設定します。

  12. お客様が購入するたびにヴォールト カードのCVV番号を確認する場合は、Enable Vault CVV Re-verification​を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など、決済プロセスの開始時にExpress Payment オプションを使用して、より迅速な決済エクスペリエンスを提供するには、Enable Checkout Express Payments​をYesに設定します。

  5. 高度な不正ツールのチェックの一環としてトランザクションを評価用に送信しないようにするには、管理者を通じて行われた注文に対して、Skip Fraud Checks on Admin Orders​をYesに設定します。

  6. しきい値を満たすか、しきい値を超えたときにAdvanced Fraud Protection チェックがバイパスされるように、Bypass Fraud Protection Threshold​を設定します。

    このフィールドを空白にすると、このオプションは無効になります。

  7. ストアとBraintree間のやり取りのログファイルを保存する場合は、Debug​をYesに設定します。

  8. クレジットカードの裏面から3桁のセキュリティコードを提供するように顧客に要求するには、CVV Verification​をYesに設定します。

    CVV検証を使用する場合は、Braintree アカウントの​Settings/Processing セクションでAVSまたはCVVを有効にしてください。

  9. すべての支払い方法のカート行項目を送信するには、Send Card Line Items​をYesに設定します。

  10. Credit Card Types​の場合、店舗で支払いに受け入れられている各クレジットカードをBraintreeを通じてお支払いとして選択します。

    複数の種類のカードを選択するには、Ctrl キー(PC)またはCommand キー(Mac)を押しながら、各オプションをクリックします。

  11. Sort Order​に数字を入力して、チェックアウト時にBraintreeが他の支払い方法と共に表示されるときに表示される順序を決定します。

手順4:BraintreeのWebhook設定を完了する

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

  1. Enable Webhook​をYesに設定して、不正利用防止、ACH支払い、およびローカル支払い方法のWebhook機能を有効にします。

  2. Fraud Protection URL フィールドのURLをコピーし、Webhook Destination URL​としてBraintree アカウントに追加します。

    note important
    IMPORTANT
    このURLは安全で一般に公開できる必要があります。
  3. Fraud Protection Approve Order Status フィールドを設定して、Braintreeで不正防止が承認されるタイミングを判断します。

    選択した注文ステータスは、Commerce注文に割り当てられます。

  4. Braintreeによって不正防止が拒否されるタイミングを判断するには、Fraud Protection Reject Order Status フィールドを設定します。

    選択した注文ステータスは、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"}

  1. ACHをBraintreeの支払いオプションとして含めるには、Enable ACH Direct Debit​をYesに設定します。

  2. 顧客は、1回限りのACH ダイレクトデビット支払い方法を保管し、今後の使用に備えて保管することができます。 Enable Vault for ACH Direct Debit​からYesに設定されている場合、顧客は支払い情報を再入力または認証する必要なく、ACH Direct Debitを再利用できます。

  3. Sort Order​に番号を入力して、チェックアウト時に他の支払いオプションと共に表示されるBraintree ACH支払いオプションが表示される順序を決定します。

手順7: Braintreeの設定でApple Payを完了する

Braintree設定によるApplePay {width="600" modal="regular"}

  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 ページに表示されるボタンに使用するテキストを入力して、お客様をweb サイトに戻します(例: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
    バンドルされたBraintree拡張機能は、Braintree開発者ドキュメント ​に記載されているすべてのローカル支払い方法をサポートしていません。 その他のローカル支払い方法は、今後のリリースでサポートされる予定です。
  6. Sort Order​に番号を入力して、チェックアウト中に他の支払いオプションと共に表示されるローカル支払い方法が表示される順序を決定します。

手順9: Braintreeの設定でGoogle Payを完了する

Braintree経由のGoogle支払い {width="600" modal="regular"}

  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 ボタンの色を決定します:WhiteまたはBlack

  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. セキュリティで保護されたVaultを使用して顧客のVenmo アカウントを保存できるようにするには、Enable Vault for Venmo​をYesに設定して、今後のトランザクションのために顧客がVenmo アカウントに再度ログインする必要がないようにします。

    Braintree経由のVenmo {width="600" modal="regular"}

  3. Payment Action​を次のいずれかに設定します:

    • Authorize Only – 購入を承認し、資金を保留します。 金額は、販売者が販売を​ 獲得 ​するまで、顧客の銀行口座から引き出されません。
    • Intent Sale – 購入金額が承認され、お客様のアカウントから直ちに引き落とされます。
  4. Sort Order」に数値を入力して、チェックアウト中に他の支払いオプションと共に表示されるときにVenmoが表示される順序を決定します。

ステップ 11:BraintreeでPayPalを完了する

Braintree設定1 {width="550" modal="regular"}を使用したPayPal

  1. Braintreeの支払いオプションとしてPayPalを含めるには、Enable PayPal through Braintree​をYesに設定します。

  2. Braintreeのお支払い方法でPayPalを指定します。

    note
    NOTE
    PayPal Credit​または​ PayPal PayLater ​を有効にできます。 両方のメソッドを同時に有効にすることはできません。
    • PayPal CreditをBraintreeの支払いオプションとして含めるには、Enable PayPal Credit through Braintree​をYesに設定します。

      Braintreeを通じてPayPalを有効にする​がYesに設定されている場合、このフィールドのみが表示されます。

      note
      NOTE
      PayPal Creditは、米国および英国でのみ利用可能です。 Merchant Country​フィールドで選択した値がUSまたはUKでない場合、PayPal クレジットは無効になります。
    • PayPal PayLaterをBraintreeの支払いオプションとして含めるには、Enable PayPal PayLater through Braintree​をYesに設定します。

      Enable PayPal PayLater through Braintree​がYesに設定されている場合、このフィールドのみが表示されます。

      3​でのお支払いなど、オファーに関する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」に数字を入力して、チェックアウト時にBraintree PayPalの支払いオプションが他の支払いオプションと共に表示されるときに表示される順序を決定します。

  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)を押しながら、お客様が店舗で購入できる国をリストから選択します。

    Braintree設定を使用したPayPal 2 {width="550" modal="regular"}

  10. お客様に請求先住所の提供を求めるには、Require Customer’s Billing Address​をYesに設定します。

    note
    NOTE
    この機能は、PayPal テクニカルサポートによってアカウントに対して有効にする必要があります。
  11. PayPal Expressの注文レビューページをスキップするには、Skip Order Review Step​をYesに設定します。

    PayPal Expressでお支払いのお客様:お支払いを完了する前にレビューページにリダイレクトする場合は、これをNoに設定します。 お客様がレビューページをスキップする場合は、Yesに設定します。

  12. ストアとPayPalのインタラクションのログファイルをBraintree経由で保存するには、Debug​をYesに設定します。

  13. ミニカートとショッピングカートページの両方にPayPal ボタンを表示するには、Display on Shopping Cart​をYesに設定します。

  14. パッケージの追跡情報をPayPalに送信するには、Send Package Tracking​をYesに設定します。

    パッケージの追跡情報は、PayPalの取引/注文の場合にのみPayPalに送信されます。 Package Tracking機能が正しく動作するには、Send Cart Line Items for PayPal設定フィールドを有効にする必要があります。

  15. パッケージのトラッキング更新をPayPalで購入者または支払い者に通知するには、Use PayPal’s “Notify Payer” functionality​をYesに設定します。

手順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​を3種類のボタンのいずれかに設定します:PayPal Button / PayPal Pay Later Button / PayPal Credit Button

PayPal Button

このセクションのオプションと設定は、PayPal Button Type​フィールドで選択したボタンの種類によって異なります。

  1. 選択した場所のストアフロントにPayPal ボタンを表示するには、Show PayPal Button​をYesに設定します。

  2. Button Label​の場合、PayPal ボタンラベルを選択します:PaypalCheckoutBuynow、またはPay

  3. Color​の場合、PayPal ボタンの色を選択します:BlueBlackGold、またはSilver

  4. Shape​の場合、PayPal ボタンの形状を選択します:PillまたはRectangle

  5. Size (Deprecated)​の場合、PayPal ボタンのサイズを選択してください:MediumLarge、またはResponsive

NOTE
Size(Deprecated)​設定フィールドは廃止され、PayPal ボタンのスタイル設定には使用されません。

これらのオプションを設定すると、PayPal ボタンのプレビューが表示されます。 設定の適用や値のリセットに使用できるコントロールがあります。

  • ボタンとPayLater メッセージの選択したスタイル設定を保存し、現在の場所とボタンの種類に適用するには、Apply​をクリックします。

  • ボタンとPayLater メッセージの値に対して選択したスタイル設定を保存し、すべてのボタンの種類と場所に適用するには、Apply to All Buttons​をクリックします。

  • ボタンとPayLater メッセージの推奨されるデフォルト値にスタイル設定を戻し、すべてのボタンの種類と場所に適用するには、Reset to Recommended Defaults​をクリックします。

ステップ 13:後払いメッセージ

Product Page

後払いメッセージ – 製品ページ設定 {width="600" modal="regular"}

  1. ストアフロントでPay Later メッセージを製品ページに表示するには、Show PayLater Messaging​をYesに設定します。

    利用可能なオファーに対する後払いメッセージを表示します。 制限が適用されます。 PayPalのドキュメント ​を参照してください。

  2. Message Layout​の場合、Pay Later メッセージレイアウトを選択します:TextまたはFlex

  3. Logo​の場合、PayPal ロゴの種類(InlinePrimaryAlternative、またはNone)を選択します

  4. Logo Position​の場合、PayPal ロゴの位置を選択します:LeftRight、またはTop

  5. Text Color​の場合、PayLater メッセージのテキストカラーを選択します:BlackWhiteMonochrome、またはGrayscale

Cart

後払いメッセージ – カート ページの設定 {width="600" modal="regular"}

  1. ミニカートまたはカートページでPay Later メッセージをストアフロントに表示するには、Show PayLater Messaging​をYesに設定します。

    利用可能なオファーに対する後払いメッセージを表示します。 制限が適用されます。 PayPalのドキュメント ​を参照してください。

  2. Message Layout​の場合、Pay Later メッセージレイアウトを選択します:TextまたはFlex

  3. Logo​の場合、PayPal ロゴの種類(InlinePrimaryAlternative、またはNone)を選択します

  4. Logo Position​の場合、PayPal ロゴの位置を選択します:LeftRight、またはTop

  5. Text Color​の場合、PayLater メッセージのテキストカラーを選択します:BlackWhiteMonochrome、またはGrayscale

Checkout

後払いメッセージ – チェックアウトページ設定 {width="600" modal="regular"}

  1. チェックアウト時にストアフロントにPay Later メッセージを表示するには、Show PayLater Messaging​をYesに設定します。

    利用可能なオファーに対する後払いメッセージを表示します。 制限が適用されます。 PayPalのドキュメント ​を参照してください。

  2. Text Align​の場合、Pay Later メッセージのテキスト整列を選択します:TextCenter、またはRight

  3. Text Color​の場合、Pay Later メッセージのテキストカラーを選択します:BlackWhite

手順14: 3D検証設定を完了する

  1. 確認プログラムに登録されているクレジットカード(VISA​による確認など)を使用しているお客様に対して確認手順を追加する場合は、3D Secure Verification​をYesに設定します。

    このプロセスでは、検証用に送信されたトランザクション金額が、承認用に送信された金額と照合されます。

  2. すべてのトランザクションに対して常に3D セキュア要求にチャレンジするには、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"}

手順15:Braintree動的記述子の設定

顧客のクレジットカード明細書の購入を識別するには、次の記述子を使用します。 各購入に関連する企業を明確に特定することで、チャージバックの数を減らすことができます。 アカウントで動的記述子が有効になっていない場合は、Braintree サポートにお問い合わせください。

動的な記述子 {width="600" modal="regular"}

  1. 次のガイドラインに従って、NamePhone​および​ URL ​の動的記述子を入力します。

    • Name – 名前記述子には、アスタリスク (*)で区切られた2つの部分があります。 例:

      company*myproduct

      記述子の最初の部分は会社またはDBAを識別し、2番目の部分は製品を識別します。 ディスクリプタのcompany部分とproduct部分の長さは、次の方法で割り当てることができます。組み合わせた長さは最大22文字です。

      名前記述子​の文字

      Option 1 :Companyは3文字である必要があります。Productは最大18文字です

      Option 2 :Companyは7文字である必要があります。Productは最大14文字です

      オプション 3: Companyは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 Source 2.4.0以降、Braintree拡張機能はリリースに含まれています。 Marketplace Braintree拡張機能がインストールされている2.4.0より前のバージョンからCommerce 2.4.xに移行する場合は、その拡張機能(paypal/module-braintreeまたはgene/module-braintree)をアンインストールし、Magento_BraintreeではなくPayPal_Braintree名前空間を使用するようにコードを更新する必要があります。 コアのCommerce Braintree Payments バンドル拡張機能およびCommerce Marketplaceに配布された拡張機能の設定設定は保持され、以前のバージョンに配置された支払いは、引き続き通常どおりキャプチャ、無効化、または払い戻しできます。

recommendation-more-help
commerce-admin-help-stores-purchase