Braintree

Braintreeは、不正検知と PayPal 統合により、完全にカスタマイズ可能なチェックアウトエクスペリエンスを提供します。 Apple Pay、Google Pay、ACH、Venmo、およびローカルの支払い方法をサポートします。 BraintreeはBraintreeシステムで行われるので、マーチャントの PCI コンプライアンスに関する負担を軽減できます。 Braintreeペイメントの統合は、GENE Commerce によって開発されました。

NOTE
以前のバージョンのAdobe CommerceまたはCommerce MarketplaceのBraintree拡張機能がインストールされた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.6.1 - リリースノート」セクションで、「Configure」をクリックします。

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

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

  5. Braintreeトランザクションの現在の Environment 業状況を Sandbox または Production に設定します

    サンドボックスで設定をテストする場合は、Braintreeで推奨されている クレジットカード番号のみを使用します。 Braintreeを使用して実稼動に移行する準備が整ったら、EnvironmentProduction に設定します。

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

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

    • Authorize Only – 購入を承認し、資金を保留します。 加盟店が売却 キャプチャ するまで、お客様の銀行口座から金額は引き出されません。
    • Intent Sale – 購入金額は許可され、すぐにお客様のアカウントから引き出されます。 メモ: この値は、2.3.x 以前のリリースでは 認証してキャプチャ されていました。|
  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 PaymentsYes に設定します。

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

    顧客情報を安全に保存する機能を希望し、顧客が購入するたびに情報を再入力する必要がない場合は、Enable Vault for Card PaymentsYes に設定します。

手順 3:詳細設定の完了

  1. 展開セレクター 」を展開し、「Advanced Braintree Settings」セクションを展開します。

    詳細設定 {width="550" modal="regular"}

  2. Vault Title しくは、顧客カード情報が格納されている Vault を識別する、参照の説明的なタイトルを入力します。

  3. Braintreeアカウントから Merchant Account ID を入力します。

    使用するマーチャントアカウントを指定しない場合、Braintreeはデフォルトのマーチャントアカウントを使用して取引を処理します。

  4. PayPal、PayLater、Apple Pay、Google Pay など、チェックアウトプロセスの開始時に Express Payment オプションを使用して迅速にチェックアウトできるようにするために、Enable Checkout Express PaymentsYes に設定します。

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

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

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

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

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

    CVV 検証を使用する場合は、Braintreeアカウントの 設定/処理中 セクションで AVS や CVV を必ず有効にしてください。

  9. すべての支払い方法で買い物かご品目を送信するには、Send Card Line ItemsYes に設定します。

  10. Credit Card Types しくは、Braintreeで支払いを受け付ける各クレジットカードを選択します。

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

  11. Sort Order の場合は、番号を入力して、チェックアウト時に他の支払い方法と一緒にリストされたときにBraintreeが表示される順序を指定します。

手順 4:BraintreeWebhook を設定する

Braintree Webhook の設定

  1. Enable WebhookYes に設定すると、不正防止、ACH 支払いおよびローカル支払い方法の Webhook 機能が有効になります。

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

    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による ACH

  1. Braintreeの支払い方法として ACH を含めるには、Enable ACH Direct DebitYes に設定します。

  2. お客様は、1 回限りの ACH Direct Debit 支払い方法をヴォールティングし、将来の使用のために保存できます。 ヴォールト後、お客様は ACH Direct Debit を再利用できます。Yes に設定されている場合は、支払い情報を再入力または認証する必要は Enable Vault for ACH Direct Debit りません。

  3. Sort Order の場合は、番号を入力して、チェックアウト時に他の支払い方法と一緒に表示されるBraintreeの ACH 支払い方法の順序を指定します。

手順 7:Braintree設定から Apple Pay を完了する

Braintree設定を使用した ApplePay

  1. Braintree付きの支払い方法として Apple Pay を含めるには、Enable ApplePay through BraintreeYes に設定します。

    最初に、Braintreeアカウントに ドメイン名を確認してください。

  2. お客様の情報を安全に保存し、Apple Pay で購入するたびに情報を再入力する必要がない場合は、Enable Vault for ApplePayYes に設定します。

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

    • Authorize Only – 購入を承認し、資金を保留します。 この金額は、マーチャントによって売却が キャプチャ されるまで、顧客の銀行口座から引き出されません。
    • Intent Sale – 購入金額は許可され、すぐにお客様のアカウントから引き出されます。
  4. Merchant Name: Apple Pay ダイアログで顧客に表示されるラベルを指定するテキストを入力します。

  5. Sort Order:番号を入力して、チェックアウト時に他の支払いオプション Apple Pay 一緒にリストされたときに支払いオプションが表示される順序を決定します。

手順 8:現地の支払方法の設定を完了する

  1. Braintree付きの支払い方法としてローカルの支払い方法を含めるには、Enable Local Payment MethodsYes に設定します。

  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
    NOTE
    バンドルされたBraintree拡張機能は、Braintree開発者向けドキュメントに記載されているすべてのローカル支払い方法をサポートしているわけではありません。 今後のリリースでサポートされる予定の、その他の地域での支払い方法も開発中です。
  6. Sort Order:番号を入力して、チェックアウト時に他の支払オプションとともに表示されるローカル支払方法の表示順序を決定します。

手順 9:Braintree設定から Google Pay を完了する

Google ペイ スルーBraintree

  1. Braintree付きの支払い方法として Google Pay を含めるには、Enable GooglePay Through BraintreeYes に設定します。

  2. お客様の情報を安全に保存し、Google Pay で購入するたびに情報を再入力する必要がない場合は、Enable Vault for GooglePayYes に設定します。

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

    • Authorize Only – 購入を承認し、資金を保留します。 この金額は、マーチャントによって売却が キャプチャ されるまで、顧客の銀行口座から引き出されません。
    • Intent Sale – 購入金額は許可され、すぐにお客様のアカウントから引き出されます。
  4. Google Pay ボタンの色を決定するには、Button Color を設定します: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 BraintreeYes に設定します。

  2. 顧客が今後のトランザクションで Venmo アカウントに再度ログインする必要がないように、セキュアなコンテナを使用して顧客の Venmo アカウントを保存できるようにするには、Enable Vault for VenmoYes に設定します。

    Braintreeによる Venmo {width="600" modal="regular"}

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

    • Authorize Only – 購入を承認し、資金を保留します。 この金額は、マーチャントによって売却が キャプチャ されるまで、顧客の銀行口座から引き出されません。
    • Intent Sale – 購入金額は許可され、すぐにお客様のアカウントから引き出されます。
  4. Sort Order の場合は、番号を入力して、チェックアウト時に他の支払いオプションと一緒に表示される Venmo の表示順序を決定します。

手順 11:Braintreeを使用して PayPal を設定する

Braintree設定を使用した PayPal

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

  2. Braintreeの支払い方法で PayPal を指定してください:

    note note
    NOTE
    PayPal Credit または PayPal PayLater のいずれかを有効にできます。 両方のメソッドを同時に有効にすることはできません。
    • Braintree付きの支払い方法として PayPal Credit を含めるには、Enable PayPal Credit through BraintreeYes に設定します。

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

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

      Enable PayPal PayLater through BraintreeYes に設定すると、このフィールドのみが表示されます。

      3 で支払う などのオファーでは、サイトに PayLater メッセージを表示できます。この場合、顧客は 3 回の支払いを無利子で行うことができます。 Braintree統合では、この機能を宣伝するために、サイトにメッセージを表示できます。 PayLater オファーを、他のコンテンツ、マーケティングまたはマテリアルでプロモーションすることはできません。

  3. Title しくは、チェックアウト時の PayPal によるBraintree支払いを識別するタイトルを入力します。

  4. Vault EnabledYes に設定すると、顧客の PayPal アカウントを保存するためのセキュアなコンテナを使用できるようになります。 ヴォールティングされた PayPal アカウントは、将来のトランザクションに使用でき、顧客のステップ数を減らすことができます。

  5. 行項目(注文項目)を PayPal に送信し、ギフトカード、商品のギフトラッピング、注文のギフトラッピング、ストアクレジット、配送、税を行項目として送信するには、Send Cart Line Items for PayPalYes に設定します。

  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 AddressYes に設定します。

    note note
    NOTE
    この機能は、PayPal テクニカルサポートがお使いのアカウントで有効にする必要があります。
  11. Braintreeを使用してストアと PayPal 間のやり取りのログファイルを保存するには、DebugYes に設定します。

  12. ミニカートと買い物かごページの両方に PayPal ボタンを表示するには、Display on Shopping CartYes に設定します。

手順 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 の 3 種類のボタンのいずれかに設定します。

PayPal Button

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

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

  2. Button Label しくは、PayPal ボタンのラベル(PaypalCheckoutBuynowPay のいずれか)を選択します

  3. Color しくは、PayPal ボタンの色(BlueBlackGoldSilver のいずれか)を選択します

  4. Shape の場合は、[PayPal] ボタン図形(Pill または Rectangle)を選択します

  5. Size (Deprecated) しくは、PayPal ボタンのサイズ(MediumLargeResponsive)を選択します

NOTE
Size(Deprecated) 設定フィールドは非推奨となり、PayPal ボタンのスタイル設定には使用されません。

PayLater Messaging

  1. 選択した場所のストアフロントに PayLater メッセージを表示するには、「Show PayLater Messaging」を「Yes」に設定します。

    このメッセージには、使用可能なオファー PayLater メッセージの表示が含まれます( 制限あり)。

  2. Message Layout の場合は、PayLater のメッセージレイアウト(Text または Flex)を選択します。

  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 VerificationYes に設定します。

    プロセス中に、検証用に送信されたトランザクション金額と、認証用に送信された金額がチェックされます。

  2. すべてのトランザクションに対して 3D セキュア要求に常にチャレンジするには、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サポートにお問い合わせください。

動的記述子

  1. 次のガイドラインに従って、NamePhoneURL の動的記述子を入力します。

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

      company*myproduct

      記述子の最初の部分は会社または DBA を示し、2 番目の部分は製品を示します。 記述子の companyproduct の部分の長さは、次のように、最大 22 文字の長さを組み合わせて割り当てることができます。

      名前記述子に含まれる文字

      オプション 1: Company は 3 文字にする必要があります Product、最大 18 文字にすることができます

      オプション 2: Company は 7 文字、最大 14 文字 Product する必要があります

      オプション 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の主要な支払いバンドル拡張機能および拡張機能で配布されたCommerce Marketplaceが保持され、以前のバージョンで行われた支払いは、通常どおりキャプチャ、無効化または払い戻しできます。

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