Braintree
Braintreeは、不正検知と PayPal 統合により、完全にカスタマイズ可能なチェックアウトエクスペリエンスを提供します。 をサポートします Apple Pay, Google Pay、ACH、Venmo およびローカル支払い方法。 BraintreeはBraintreeシステムで行われるので、マーチャントの PCI コンプライアンスに関する負担を軽減できます。 Braintree支払いの統合は、次の方法で開発されました。 ジーンCommerce.
手順 1:Braintree資格情報を取得する
に移動 Braintree支払い アカウントに新規登録します。
手順 2：基本設定を完了する
-
日 Admin サイドバー、に移動 Stores > Settings>Configuration.
-
左側のパネルで、を展開します Sales を選択します Payment Methods.
-
Commerceのインストールに複数の web サイト、ストア、ビューがある場合は、左上隅にある Store View 設定が適用される場所。
-
が含まれる Merchant Location セクションで、次のことを確認します Merchant Country は、ビジネスの場所に設定されます。
-
-
次の下 Recommended Solutions、内_Braintree Payments （基準： ジーンCommerce v4.6.1 - リリースノート_セクションで、をクリック Configure.
-
の場合 Title を入力し、チェックアウト時に支払いオプションとしてBraintreeを識別するタイトルを入力します。
-
現在の操作を設定 Environment Braintree取引の対象
SandboxまたはProductionサンドボックスで設定をテストする場合は、のみを使用します クレジットカード番号 Braintreeが推奨します。 Braintreeを使用して実稼動に移行する準備ができたら、次のように設定します Environment 対象：
Production.
-
を設定 Payment Action を次のいずれかに変更します。
Authorize Only– 購入を承認し、資金を保留します。 金額は、セールが行われるまで、顧客の銀行口座から引き出されません キャプチャ済み 商人による。|Intent Sale– 購入金額が承認され、すぐにお客様のアカウントから引き出されます。 注意： この値 認証とキャプチャ 2.3.x 以前のリリース。|
-
を入力 Sandbox Merchant ID / Merchant ID Braintreeアカウントから。
-
Braintreeアカウントから次の資格情報を入力します。
- Sandbox Public Key / Public Key
- Sandbox Private Key / Private Key
note note NOTE 両方のフィールドが別々にあります （サンドボックスと実稼動） 環境、およびその他のフィールドは、選択した環境に基づいてレンダリングされます。 -
設定を保存する前に、 Validate Credentials をクリックして認証情報を検証します。
-
を設定 Enable Card Payments 対象：
Yes.
顧客情報を安全に保存する機能が必要なので、顧客が購入するたびに情報を再入力する必要がない場合は、次のように設定します Enable Vault for Card Payments 対象：
Yes.
手順 3：詳細設定の完了
-
を展開
-
の場合 Vault Title を入力し、顧客カード情報が保存されている Vault を識別する参照の説明的なタイトルを入力します。
-
を入力 Merchant Account ID Braintreeアカウントから。
使用するマーチャントアカウントを指定しない場合、Braintreeはデフォルトのマーチャントアカウントを使用して取引を処理します。
-
PayPal、PayLater、Apple Pay、Google Pay など、チェックアウトプロセスの開始時に Express Payment オプションを使用して、より迅速にチェックアウトをおこなえるようにします。 Enable Checkout Express Payments 対象：
Yes. -
高度な不正ツールのチェックの一環として評価のためにトランザクションが送信されないようにするには、管理者を通じて行われた注文に対して、次のように設定します Skip Fraud Checks on Admin Orders 対象：
Yes. -
を Bypass Fraud Protection Threshold その結果、
Advanced Fraud Protectionしきい値に達した、またはしきい値を超えた場合、チェックはバイパスされます。このフィールドを空白にすると、このオプションが無効になります。
-
ストアとBraintree間のやり取りのログファイルを保存する場合は、次のように設定します。 Debug 対象：
Yes. -
クレジットカードの裏面から 3 桁のセキュリティコードを提供するよう顧客に要求するには、次のように設定します CVV Verification 対象：
Yes.CVV 検証を使用する場合は、で AVS や CVV を必ず有効にします。 設定/処理 Braintreeアカウントの「」セクション。
-
すべての支払方法に対してカート品目を送信するには、次のように設定します Send Card Line Items 対象：
Yes. -
の場合 Credit Card Types で、Braintreeを通じて支払いとしてストアで受け入れられる各クレジットカードを選択します。
複数のカードの種類を選択するには、Ctrl キー（PC）または Command キー（Mac）を押したまま、各オプションをクリックします。
-
の場合 Sort Order：数字を入力して、チェックアウト時に他の支払い方法と一緒にリストされたときにBraintreeが表示される順序を決定します。
手順 4:BraintreeWebhook を設定する
-
を設定 Enable Webhook 対象：
Yes詐欺保護、ACH 支払いおよびローカル支払い方法の Webhook 機能を有効にします。 -
URL をにコピー Fraud Protection URL フィールドに入力し、Braintreeアカウントに Webhook Destination URL.
note important IMPORTANT この URL はセキュリティで保護され、公開アクセス可能である必要があります。 -
を Fraud Protection Approve Order Status Braintreeが不正防止を承認するタイミングを決定するフィールド。
選択した注文ステータスがCommerceの注文に割り当てられます。
-
を Fraud Protection Reject Order Status Braintreeにより不正防止が拒否された場合に判断するためのフィールド。
選択した注文ステータスがCommerceの注文に割り当てられます。
手順 5：国固有の設定の完了
-
を設定 Payment from Applicable Countries を次のいずれかに変更します。
All Allowed Countries– すべてのお客様 国 ストア設定で指定されたお支払方法を使用できます。Specific Countries– このオプションを選択した後、 Payment from Specific Countries リストが表示されます。 Ctrl キー（PC）または Command キー（Mac）を押しながら、リスト内で、お客様がストアから購入できる国を選択します。
-
を設定するには Country Specific Credit Card Types:
-
クリック Add.
-
を Country およびを選択します Allowed Credit Card Type.
-
繰り返して、各国から受け入れるクレジットカードを識別します。
-
手順 6:Braintreeを使用して ACH を設定する
-
ACH をBraintreeの支払いオプションとして含めるには、次のように設定します Enable ACH Direct Debit 対象：
Yes. -
お客様は、1 回限りの ACH Direct Debit 支払い方法をヴォールティングし、将来の使用のために保存できます。 ヴォールト後、お客様は、設定されている場合に支払情報を再入力または認証する必要なく、ACH 口座引落しを再利用できます Enable Vault for ACH Direct Debit 対象：
Yes. -
の場合 Sort Order 数字を入力して、チェックアウト時に他の支払い方法と一緒に表示されるBraintreeACH 支払い方法の表示順序を指定します。
手順 7：を完了する Apple Pay Braintree設定を使用
-
次を含める Apple Pay Braintree付き支払いオプションとして、を設定します Enable ApplePay through Braintree 対象：
Yes.必ずしてください ドメイン名の確認 まずBraintreeアカウントから。
-
お客様の情報を安全に保存し、Apple Pay で購入するたびに再入力する必要がない場合は、次のように設定します。 Enable Vault for ApplePay 対象：
Yes. -
を設定 Payment Action を次のいずれかに変更します。
Authorize Only– 購入を承認し、資金を保留します。 金額は、セールが行われるまで、顧客の銀行口座から引き出されません キャプチャ済み 商人によって。Intent Sale– 購入金額が承認され、すぐにお客様のアカウントから引き出されます。
-
の場合 Merchant Name に入力します。このテキストは、Apple Pay ダイアログで顧客に表示されるラベルを指定します。
-
の場合 Sort Order：以下の条件を満たす順序を決定する番号を入力 Apple Pay 支払いオプションは、チェックアウト時に他の支払いオプションと一緒にリストされたときに表示されます。
手順 8：現地の支払方法の設定を完了する
-
Braintree付きの支払いオプションとしてローカル支払方法を含めるには、次のように設定します Enable Local Payment Methods 対象：
Yes. -
の場合 Title で、「チェックアウトの支払方法」セクションに表示されるラベルに使用するテキストを入力します（デフォルト値：
Local Payments）に設定します。 -
の場合 Fallback Button Text に、フォールバックBraintreeページに表示され、顧客を web サイトに戻すためのボタンに使用するテキストを入力します（例：
Complete Checkout）に設定します。 -
の場合 Redirect on Fail を入力します。この URL では、ローカル支払方法トランザクションがキャンセル、失敗、またはエラーが発生した場合に顧客をリダイレクトする必要があります。 チェックアウト支払いページにする必要があります（例：
https://www.domain.com/checkout#payment）に設定します。 -
の場合 Allowed Payment Methods を選択し、有効にする現地の支払方法を選択します。
オプション：
Bancontact/EPS/giropay/iDeal/Klarna Pay Now/SOFORT/MyBank/P24/SEPA/ELV Direct Debit（まだサポートされていません）
note note NOTE バンドルされたBraintree拡張機能は、にリストされているすべてのローカル支払い方法をサポートしているわけではありません Braintree開発者向けドキュメント. 今後のリリースでサポートされる予定の、その他の地域での支払い方法も開発中です。 -
の場合 Sort Order：数字を入力して、チェックアウト時に他の支払いオプションと一緒にリストされたときにローカルの支払い方法が表示される順序を決定します。
手順 9：を完了する Google Pay Braintree設定を使用
-
次を含める Google Pay Braintree付き支払いオプションとして、を設定します Enable GooglePay Through Braintree 対象：
Yes. -
お客様の情報を安全に保存し、Google Pay で購入するたびに再入力する必要がない場合は、次のように設定します。 Enable Vault for GooglePay 対象：
Yes. -
を設定 Payment Action を次のいずれかに変更します。
Authorize Only– 購入を承認し、資金を保留します。 金額は、セールが行われるまで、顧客の銀行口座から引き出されません キャプチャ済み 商人によって。Intent Sale– 購入金額が承認され、すぐにお客様のアカウントから引き出されます。
-
を設定 Button Color の色を決定するには Google Pay ボタン：
WhiteまたはBlack -
の場合 Merchant ID を入力し、MerchantID を入力します（Googleが提供）。
-
の場合 Accepted Cards を使用して、顧客が注文に使用できるカードのタイプを選択します Google Pay.
オプション：
Visa/MasterCard/AMEX/Discover/JCB -
の場合 Sort Order：以下の条件を満たす順序を決定する番号を入力 Google Pay は、チェックアウト時に他のお支払いオプションと一緒にリストされたときに表示されます。
手順 10:Braintreeを使用して Venmo を設定する
-
Venmo をBraintreeの支払いオプションとして含めるには、次のように設定します Enable Venmo through Braintree 対象：
Yes. -
を設定 Enable Vault for Venmo 対象：
Yes安全な Vault を使用して顧客の Venmo アカウントを保存できるようにして、顧客が今後のトランザクションで Venmo アカウントに再度ログインする必要がないようにする。
-
を設定 Payment Action を次のいずれかに変更します。
Authorize Only– 購入を承認し、資金を保留します。 金額は、セールが行われるまで、顧客の銀行口座から引き出されません キャプチャ済み 商人によって。Intent Sale– 購入金額が承認され、すぐにお客様のアカウントから引き出されます。
-
の場合 Sort Order：数字を入力して、チェックアウト時に他の支払いオプションと共にリストされたときに Venmo が表示される順序を決定します。
手順 11:Braintreeを使用して PayPal を設定する
-
PayPal をBraintreeの支払いオプションとして含めるには、次のように設定します Enable PayPal through Braintree 対象：
Yes. -
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 クレジットは米国および英国でのみ利用できます。 に対して選択した値の場合、PayPal クレジットは無効になります Merchant Country フィールドが USまたはUK. -
次を含める PayPal PayLater Braintree付き支払いオプションとして、を設定します Enable PayPal PayLater through Braintree 対象：
Yes.条件 Enable PayPal PayLater through Braintree はに設定されています。
Yesこのフィールドのみが表示されます。次のようなオファーに対しては、サイトに PayLater メッセージを表示できます 3 で支払う お客様は、このオプションを使用して、毎月無利子で 3 回の支払いを行うことができます。 Braintree統合では、この機能を宣伝するために、サイトにメッセージを表示できます。 PayLater オファーを、他のコンテンツ、マーケティングまたはマテリアルでプロモーションすることはできません。
-
-
の場合 Title を入力し、チェックアウト時に PayPal オプションでBraintree支払いを識別するタイトルを入力します。
-
を設定 Vault Enabled 対象：
Yes安全な保管庫を使用して顧客の PayPal アカウントを保存できるようにする。 ヴォールティングされた PayPal アカウントは、将来のトランザクションに使用でき、顧客のステップ数を減らすことができます。 -
を設定 Send Cart Line Items for PayPal 対象：
Yes明細（受注品目）を PayPal に送信する際に、明細としてギフトカード、品目のギフトラッピング、注文のギフトラッピング、ストクレジット、出荷、税金を送信します。 -
の場合 Sort Order 数字を入力して、チェックアウト時に他のお支払い方法と一緒に表示されるBraintreePayPal 支払い方法の表示順序を指定します。
-
で定義されている商社名とは異なる商社名を表示するには ストアの設定に名前を入力します Override Merchant Name 必要に応じて表示するフィールド。
-
を設定 Payment Action を次のいずれかに変更します。
Authorize Only– 購入を承認し、資金を保留します。 金額は、セールが行われるまで、顧客の銀行口座から引き出されません キャプチャ済み 商人によって。Authorize and Capture– 購入金額が承認され、すぐにお客様のアカウントから引き出されます。
-
を設定 Payment from Applicable Countries PayPal で処理されるBraintree取引に対して、以下のいずれかに該当すること：
All Allowed Countries– すべてのお客様 国 ストア設定で指定されたお支払方法を使用できます。Specific Countries– このオプションを選択した後、 Payment from Specific Countries リストが表示されます。 Ctrl キー（PC）または Command キー（Mac）を押しながら、リスト内で、お客様がストアから購入できる国を選択します。
-
顧客に請求先住所の指定を要求するには、を設定します Require Customer’s Billing Address 対象：
Yes.note note NOTE この機能は、PayPal テクニカルサポートがお使いのアカウントで有効にする必要があります。 -
Braintreeを使用してストアと PayPal 間のインタラクションのログファイルを保存するには、次のように設定します Debug 対象：
Yes. -
ミニカートと買い物かごページの両方に PayPal ボタンを表示するには、次のように設定します Display on Shopping Cart 対象：
Yes.
手順 12：スタイル設定を指定する
-
の場合 Location で、PayPal ボタンとメッセージのレンダリング先を選択します。
Mini-Cart and Cart Page,Checkout Page、またはProduct Page
Mini-Cart and Cart Page
このセクションのオプションと設定は、の設定によって異なります Location フィールド。
- を設定 PayPal Button Type 次の 3 種類のボタンのいずれかに割り当てます。
PayPal Button/PayPal Pay Later Button/PayPal Credit Button
PayPal Button
このセクションのオプションと設定は、 PayPal Button Type フィールド。
-
選択した場所のストアフロントに PayPal ボタンを表示するには、を設定します Show PayPal Button 対象：
Yes. -
の場合 Button Label を選択し、「PayPal」ボタンラベルを選択します。
Paypal,Checkout,Buynow、またはPay -
の場合 Color で、PayPal ボタンの色を選択します。
Blue,Black,Gold、またはSilver -
の場合 Shape の場合は、[PayPal ボタン ] 図形を選択します。
PillまたはRectangle -
の場合 Size (Deprecated) を選択し、PayPal ボタンのサイズを選択します。
Medium,Large、またはResponsive
PayLater Messaging
-
表示対象 PayLater 選択した場所のストアフロントでのメッセージ、を設定 Show PayLater Messaging 対象：
Yes.このメッセージには、次の項目が表示されます PayLater 使用可能なオファーのメッセージング （制限が適用されます）に設定します。
-
の場合 Message Layout を選択し、 PayLater メッセージのレイアウト：
TextまたはFlex -
の場合 Logo で、PayPal ロゴのタイプを選択します。
Inline,Primary,Alternative、またはNone -
の場合 Logo Position を選択し、PayPal ロゴの位置を選択します。
Left,Right、またはTop -
の場合 Text Color を選択し、 PayLater メッセージのテキストの色：
Black,White,Monochrome、またはGrayscale
これらのオプションを設定すると、PayPal ボタンと PayLater メッセージのプレビューが表示されます。 設定の適用や値のリセットに使用できるコントロールがあります。
-
ボタンおよび PayLater メッセージング用に選択したスタイル設定を保存し、現在の場所および現在のボタン タイプに適用するには、をクリックします。 Apply.
-
ボタンおよび PayLater メッセージング値に対して選択したスタイル設定を保存し、それらをボタンのすべてのタイプと場所に適用するには、 Apply to All Buttons.
-
スタイル設定をボタンと PayLater メッセージに推奨されるデフォルト値に戻し、すべてのボタンタイプと場所に適用するには、 Reset to Recommended Defaults.
手順 13: 3D 検証設定の完了
-
検証プログラムに登録されているクレジットカードを使用している顧客に対して、検証手順を追加する場合（例：） VISA で確認）、設定 3D Secure Verification 対象：
Yes.プロセス中に、検証用に送信されたトランザクション金額と、認証用に送信された金額がチェックされます。
-
すべてのトランザクションに対して常に 3D セキュア要求にチャレンジするには、次のように設定します Always request 3DS 対象：
Yes. -
の場合 Threshold Amount を入力し、3D 検証のトリガーに必要な最小注文額を入力します。
-
を設定 Verify for Applicable Countries を次のいずれかに変更します。
All Allowed Countries– すべてのお客様 国 ストア設定で指定されたお支払方法を使用できます。Specific Countries– このオプションを選択した後、 Verify for Specific Countries リストが表示されます。 Ctrl キー（PC）または Command キー（Mac）を押しながら、リスト内で、お客様がストアから購入できる国を選択します。
手順 14:Braintree動的記述子の設定
次の記述子は、顧客のクレジットカード明細書の購入を識別するために使用されます。 各購入に関連付けられている会社を明確に識別することで、チャージバックの数を減らすことができます。 動的記述子がアカウントで有効になっていない場合は、Braintreeサポートにお問い合わせください。
-
の動的記述子を入力 Name, Phone、および URL 次のガイドラインに従います。
-
Name – 名前記述子にはアスタリスク（*）で区切られた 2 つの部分があります。 例：
company*myproduct記述子の最初の部分は会社または DBA を示し、2 番目の部分は製品を示します。 の長さ
companyおよびproduct記述子の一部は、以下の方法で、合計 22 文字まで割り当てることができます。名前記述子に含まれる文字
オプション 1:
Company3 文字にする必要があります。Product最大 18 文字まで指定できますオプション 2:
Company7 文字にする必要があります。Product最大 14 文字まで指定できますオプション 3:
Company12 文字にする必要があります。Product最大 9 文字まで指定できます -
Phone – 電話記述子の長さは 10 ～ 14 文字で、数字、ダッシュ、括弧、ピリオドのみを含めることができます。 例：
9999999999(999) 999-9999999.999.9999 -
URL - URL 記述子はドメイン名を表し、最大 13 文字にすることができます。 例：
company.com
-
-
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）を選択し、コードのカスタマイズを更新して、 PayPal_Braintree の代わりにの名前空間 Magento_Braintree. Commerce Braintreeの主要な支払いバンドル拡張機能および拡張機能で配布されたCommerce Marketplaceが保持され、以前のバージョンで行われた支払いは、通常どおりキャプチャ、無効化または払い戻しできます。