Sales > Payment Methods > Braintree

IMPORTANT
Commerce 2.4 の移行:

Adobe CommerceとMagento Open Sourceが 2.4.0 より前のバージョンの場合、マーチャントは、コア統合の代わりに、公式のBraintree支払い統合拡張機能を 🔗0}Commerce Marketplace} からインストールして設定することをお勧めします。 2.4.0 以降、拡張機能はコアリリースに含まれるようになりました。



Commerce 2.4 に移行する場合、マーケットプレイス(paypal/module-braintree または gene/module-braintree)で配布されている拡張機能をアンインストールし、Magento_Braintree の代わりに PayPal_Braintree 名前空間を使用するようにコードをカスタマイズする必要があります。 Commerce用にバンドルされた拡張機能の設定とCommerce Marketplaceで配布された拡張機能は保持されます。 これらのバージョンの拡張機能で行われた支払いは、通常どおりキャプチャ、無効化、または払い戻されます。



Commerce 2.4.0 にアップグレードする場合、以前の 2.3.x バージョンで推奨されるCommerce Marketplace拡張機能を使用しないと、マルチアドレス機能はBraintree 2.4.0 バージョンで動作しません。 買い物客が 複数のアドレスに配信 を選択すると、Braintreeの支払い方法が表示されません。 2.3.x で以前に推奨したCommerce Marketplace拡張機能には、この複数のアドレスの問題があります。

ストアの設定にアクセスするには、「管理 _サイドバーから​ Stores/Settings/Configuration を選択し _す。

IMPORTANT
カードに予想外の料金が発生した場合は、 サブスクリプションをキャンセルページでサポートを受けることができます。

Basic Braintree Settings

Braintreeの基本設定

フィールド
範囲
説明
Title
ストア表示
デフォルト値: Credit Card (Braintree)
Environment
ストア表示
オプション:Sandbox / Production
Payment Action
ストア表示
支払が処理されるときにBraintreeが実行するアクションを決定します。 オプション:
Authorize– 顧客のクレジットカードの資金は許可されていますが、アカウントから転送されません。 注文が ストア 管理で作成されます。 後で販売をキャプチャし、請求書を作成できます。
Intent Sale (以前のリリースで以前に Authorize and Capture ) - 顧客のクレジットカードの資金はBraintreeによって承認およびキャプチャされ、注文と請求書はストア管理で作成されます。
Sandbox Merchant ID
ストア表示
これは、サンドボックス ゲートウェイ アカウント全体の一意の識別子です。 パブリック ID または​ 本番 ID とも呼ばれるマーチャント ID は、本番ゲートウェイとサンドボックス ゲートウェイで異なります。このフィールドは、「 Environment」フィールドが「 Sandbox」に設定されている場合に表示されます。
Sandbox Public Key
ストア表示
This is your user-specific, public identifier that restricts access to encrypted data. Each user associated with your Sandbox Braintree gateway has their own sandbox public key. このフィールドは、「Environment」フィールドが「Sandbox」に設定されている場合に表示されます。
Sandbox Private Key
ストア表示
これは、暗号化されたデータへのアクセスを制限する、ユーザー固有のプライベート識別子です。 Each user associated with your Sandbox Braintree gateway has their own private key for the sandbox. このフィールドは、「Environment」フィールドが「Sandbox」に設定されている場合に表示されます。
Merchant ID
ストア表示
これは、ゲートウェイに存在する複数のマーチャントアカウントを含む、ゲートウェイアカウント全体の一意の ID です。 パブリック ID または 実稼動 ID とも呼ばれ、マーチャント ID は実稼動ゲートウェイとサンドボックスゲートウェイで異なります。 このフィールドは、「Environment」フィールドが「Production」に設定されている場合に表示されます。
Public Key
ストア表示
This is your user-specific, public identifier that restricts access to encrypted data. Braintree ゲートウェイに関連付けられた各ユーザーは、独自の公開鍵を持ちます。 このフィールドは、「Environment」フィールドが「Production」に設定されている場合に表示されます。
Private Key
ストア表示
これは、暗号化されたデータへのアクセスを制限する、ユーザー固有のプライベート識別子です。 Braintree Gateway に関連付けられた各ユーザーには、独自の秘密鍵があります。 このフィールドは、「Environment」フィールドが「Production」に設定されている場合に表示されます。
Enable Card Payments
Web サイト
Braintreeのクレジットカードによる支払い方法が、お客様の支払い方法として利用可能かどうかを判断します。 オプション:Yes / No
Enable Vault for Card Payments
Web サイト
有効にすると、は顧客の支払い情報を安全に保存できるので、顧客は購入ごとにクレジットカード情報を再入力する必要はありません。 オプション:Yes / No
Enable Vault CVV Re-verification
Web サイト
有効にすると、Braintree アカウントで設定された CVV ルールに対して検証が行われます。 オプション:Yes / No

Advanced Braintree Settings

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

フィールド
範囲
説明
Vault Title
Web サイト
顧客カード情報が保存されている Vault を識別する、参照用の説明的なタイトル。
Merchant Account ID
Web サイト
この web サイトからのBraintree取引に関連付けられるマーチャントアカウント ID。 空白の場合、Braintree アカウントのデフォルトのマーチャントアカウントが使用されます。
Enable Checkout Express Payments
Web サイト
PayPal、PayLater、Apple Pay、Google Pay など、チェックアウトプロセスの開始時に Express Payment オプションを使用して、より迅速にチェックアウトできます。 オプション:Yes / No
Skip Fraud Checks on Admin Orders
Web サイト
Yes に設定されている場合にのみ、管理者を通じて行われた注文に対して、Advanced Fraud Tools チェックの一部として評価のためにトランザクションが送信されないようにします。
オプション:Yes / No
Bypass Fraud Protection Threshold
Web サイト
しきい値に達した場合や、しきい値を超えた場合、Advanced Fraud Protection のチェックがバイパスされます。 このフィールドを空白にすると、このオプションが無効になります。
Debug
Web サイト
Braintree システムとストア間のやり取りをログファイルに記録するかどうかを指定します。 オプション:Yes / No
CVV Verification
Web サイト
顧客がクレジット カードの裏面から 3 桁のセキュリティ コードを提供する必要があるかどうかを決定します。 オプション:Yes / No
Send Card Line Items
Web サイト
すべての支払い方法の買い物かご品目を送信します。 オプション:Yes / No
Credit Card Types
Web サイト
Braintree経由で支払いとして受け入れる各クレジットカードを指定します。 Ctrl キー(またはMacの Command キー)を押したままにして、カードの組み合わせを選択します。 オプション:American Express / Visa / MasterCard / Discover / JCB / Diners / Maestro International
Sort Order
ウェブサイト
チェックアウト中にBraintreeが他の支払方法で一覧表示される順序を決定します。

Braintree Webhooks Settings

ウェブフック設定Braintree

スコープ
説明
Enable Webhook
Web サイト
詐欺防止、ACH支払い、ローカル支払い方法、および紛争のためのWebhook機能を有効にするため。 オプション: Yes / No
Fraud Protection URL
ウェブサイト
このURLを Webhook Destination URLとして Braintree アカウントに追加します。 このURLは、セキュリティで保護され、公的にアクセスできる必要があります。
Fraud Protection Approve Order Status
Web サイト
不正防止がBraintreeによって承認されると、選択された注文ステータスがCommerceの注文に割り当てられます。 This status is used to update the status of the order where the ACH payment method is used and when it moves to SETTLED in Braintree.
Fraud Protection Reject Order Status
Web サイト
When fraud protection is rejected by Braintree, the selected order status is assigned to the Commerce order. このステータスは、ACH 支払い方法が使用されている注文のステータスと、Braintreeで SETTLEMENT が使用さ DECLINED ている注文のステータスを更新するために使用されます。

Country Specific Settings

Country Specific Settings

フィールド
範囲
説明
Payment from Applicable Countries
Web サイト
Braintreeで処理される支払いをすべての国から受け入れるか、特定の国からのみ受け入れるかを指定します。 オプション:All Allowed Countries / Specific Countries
Payment from Specific Countries
ウェブサイト
該当する場合は、Braintreeが処理する支払いを受け入れる特定の国を特定します。
Country Specific Credit Card Types
ウェブサイト
Braintree が処理する支払いに対して国ごとに受け入れられるクレジット カードを識別します。 レコードは国ごとに保存されます。 オプション:
Country– 国を選択します。
Allowed Card Types - Braintreeを通じて支払いとして国から受け入れる各クレジットカードを選択します。
Add– 別の国のクレジットカードを許可する行を追加します。
Action – 許可されている国のクレジットカードの記録を削除します。

ACH through Braintree

ACH からBraintree

フィールド
範囲
説明
Enabled ACH Direct Debit
Web サイト
Braintreeを通じて支払い方法として ACH Direct Debit を含めるかどうかを決定します。 オプション:Yes / No
Enable Vault for ACH Direct Debit
Web サイト
お客様は、将来の使用のために、使い捨ての ACH 口座引落し支払方法をヴォールティング/保存できます。 支払詳細がヴォールトされると、お客様はデータの再入力や支払情報の再認証を行うことなく、ACH 口座引落し支払方法を使用できます。 オプション:Yes / No
Sort Order
Web サイト
チェックアウト時に他の支払い方法 ACH Direct Debit 一緒にリストされる順序を決定します。

Apple Pay through Braintree

Braintree経由のApple Pay

フィールド
範囲
説明
Enable ApplePay through Braintree
Web サイト
Braintreeを通じてApple Pay を支払い方法として含めるかどうかを決定します。 オプション:Yes / No

ドメインを 最初にBraintree アカウントで検証する必要があります。
Enable Vault for ApplePay
Web サイト
お客様は、今後の使用のためにApple Pay の支払い方法をヴォールティング/保存できます。 支払い情報が保管されると、お客様はデータを再入力したり、支払い情報を再認証したりすることなく、Apple Pay を使用できます。 オプション:Yes / No
Payment Action
Web サイト
支払いが処理されたときにBraintreeが実行するアクションを指定します。 オプション:
Authorize– 顧客のカードの資金は許可されていますが、顧客のアカウントから転送されません。 注文はストア管理者で作成されます。 後で販売をキャプチャし、請求書を作成できます。
Intent Sale – 顧客のカードの資金はBraintreeによって承認および取得され、注文と請求書はストア管理で作成されます。 メモ: これは 2.3.x 以前のリリースで Authorize and Capture 行されました。
Merchant Name
ストア表示
ApplePay ポップアップで顧客に表示されるラベル。
Sort Order
Web サイト
チェックアウト時にApple Pay が他の支払い方法と共にリストされる注文を指定します。

Local Payment Methods

現地支払の方法

フィールド
スコープ
説明
Enabled Local Payment Methods
ウェブサイト
現地支払メソッドをBraintreeによる支払方法として含めるかどうかを指定します。 オプション:Yes / No
Title
Web サイト
チェックアウト支払い方法のセクションに表示されるラベル。 デフォルト値:Local Payments
Fallback Button Text
Web サイト
顧客を web サイトに戻すフォールバック Braintree ページに表示されるボタンに使用するテキストを入力します。 デフォルト値:Complete Checkout
Redirect on Fail
Web サイト
ローカルの支払方法トランザクションが取り消された場合、失敗した場合、またはエラーが発生した場合に顧客がリダイレクトされる URL を指定します。 チェックアウト支払いページにする必要があります(例:https://www.domain.com/checkout#payment)。
Allowed Payment Method
Web サイト
有効化するローカルの支払方法を選択します。 オプション:Bancontact / EPS / iDeal / MyBank / P24 / SEPA/ELV Direct Debit
Sort Order
Web サイト
チェックアウト時にローカル支払方法が他の支払方法と共に一覧表示される順序を決定します。
NOTE
バンドルされたBraintree拡張機能は、Braintree開発者向けドキュメントにリストされているすべてのローカル支払い方法をサポートしているわけではありません。 今後のリリースでサポートされる予定の、その他の地域での支払い方法も開発中です。

GooglePay through Braintree

Braintreeを使用した GooglePay

フィールド
範囲
説明
Enabled GooglePay through Braintree
ウェブサイト
Braintreeによる支払い方法として Google Pay 支払いを含めるかどうかを指定します。 オプション: Yes / No
Enable Vault for GooglePay
ウェブサイト
お客様は、将来使用するために Google Pay のお支払い方法を保管またはストアできます。 支払い情報が保管されると、お客様はデータを再入力したり、支払い情報を再認証したりすることなく、Google Pay を使用できます。 オプション:Yes / No
Payment Action
Web サイト
支払いが処理されたときにBraintreeが実行するアクションを指定します。 オプション:
Authorize– 顧客のカードの資金は許可されていますが、顧客のアカウントから転送されません。 注文はストア管理者で作成されます。 後で販売をキャプチャし、請求書を作成できます。
Intent Sale – 顧客のカードの資金はBraintreeによって承認および取得され、注文と請求書はストア管理で作成されます。 メモ: これは 2.3.x 以前のリリースで Authorize and Capture 行されました。
Button Color
Web サイト
Google Pay ボタンの色を決定します。 オプション:White / Black
Merchant ID
ストア表示
Googleから提供された ID をここに入力する必要があります。
Accepted Cards
Web サイト
Google Pay を使用して顧客が注文に使用できるカードのタイプを選択します。
Sort Order
Web サイト
チェックアウト時にGoogle Pay が他の支払い方法と共にリストされる注文を指定します。

Venmo through Braintree

Venmo からBraintreeへ

フィールド
範囲
説明
Enable Venmo through Braintree
Web サイト
Braintreeを通じて支払い方法として Venmo を含めるかどうかを決定します。 オプション:Yes / No
Enable Vault for Venmo
Web サイト
お客様は、将来の使用のために Venmo 支払い方法をヴォールティング/保存できます。 支払いの詳細が保管されると、お客様はデータを再入力したり、支払い情報を再認証したりすることなく、Venmo 支払い方法を使用できます。 オプション:Yes / No
Payment Action
Web サイト
支払いが処理されたときにBraintreeが実行するアクションを指定します。 オプション:
Authorize– 顧客のカードの資金は許可されていますが、顧客のアカウントから転送されません。 注文はストア管理者で作成されます。 後で販売をキャプチャし、請求書を作成できます。
Intent Sale – 顧客のカードの資金はBraintreeによって承認および取得され、注文と請求書はストア管理で作成されます。 メモ: これは、2.3.x 以前のリリースでは 承認してキャプチャ されていました。
Sort Order
Web サイト
チェックアウト時に Venmo が他の支払い方法と共にリストされる順序を決定します。

PayPal through Braintree

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

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

フィールド
範囲
説明
Enable PayPal through Braintree
Web サイト
PayPal をBraintree経由の支払い方法として含めるかどうかを決定します。 オプション:Yes / No
Enable PayPal Credit through Braintree
Web サイト
PayPal クレジットをBraintree経由の支払い方法として含めるかどうかを決定します。 オプション:Yes/No。 このフィールドは、Enable PayPal through BraintreeYes に設定すると表示されます
Enable PayPal PayLater through Braintree
Web サイト
PayPal PayLater をBraintree経由の支払い方法として含めるかどうかを決定します。 オプション:Yes/No。 このフィールドは、Enable PayPal through BraintreeYes に設定すると表示されます
Title
ストア表示
チェックアウト時にBraintreeを通じてお客様に PayPal を識別するラベル。 デフォルト値:PayPal
Vault Enabled
Web サイト
有効にすると、顧客の支払い情報の安全なストレージが提供されるので、顧客は購入ごとに PayPal 情報を再入力する必要がなくなります。 オプション:Yes / No
Send Cart Line Items for PayPal
Web サイト
明細(注文品目)を PayPal に送信し、明細としてギフトカード、商品用のギフトラッピング、注文用のギフトラッピング、ストクレジット、送料、税金を送信します。 オプション:Yes / No
Sort Order
Web サイト
チェックアウト時にBraintreeを通じて PayPal が他のお支払い方法と一緒にリストされる順序を決定する数値です。
Override Merchant Name
ストア表示
各店舗表示の販売者を識別するために使用できる代替名。
Payment Action
Web サイト
支払い処理時にBraintreeを通じて PayPal が実行するアクションを指定します。 オプション:
Authorize– 顧客のカードの資金は許可されていますが、顧客のアカウントから転送されません。 注文が ストア 管理で作成されます。 後で販売をキャプチャし、請求書を作成できます。
Authorize and Capture -顧客のカードの資金は、Braintreeを通じてPayPalによって承認およびキャプチャされ、注文と請求書がストア管理者で作成されます。
Payment from Applicable Countries
ウェブサイト
PayPal によって処理される支払いを、すべての国からBraintreeを通じて受け入れるか、特定の国からのみ受け入れるかを指定します。 オプション: All Allowed Countries / Specific Countries
Payment from Specific Countries
Web サイト
該当する場合、Braintreeで処理される支払いを受け入れる特定の国を識別します。
Require Customer’s Billing Address
Web サイト
注文を送信するために顧客の請求先住所が必要かどうかを決定します。 オプション:Yes / No
Skip Order Review Step
Web サイト
支払いを完了する前に、顧客をレビューページにリダイレクトするかどうかを決定します。 オプション:Yes / No
Debug
Web サイト
Braintree システムを通じた PayPal とストア間のやり取りをログファイルに記録するかどうかを指定します。 オプション:Yes / No
Display on Shopping Cart
Web サイト
PayPal ボタンを ミニ カートおよび 買い物かごページに表示するかどうかを決定します。 オプション:Yes / No
Send Package Tracking
Web サイト
パッケージトラッキング情報は、PayPal のトランザクション/注文の場合にのみ PayPal に送信されます。 Package Tracking 機能を正しく動作させるには、Send Cart Line Items for PayPal 設定フィールドを有効にする必要があります。 オプション:Yes / No
Use PayPal’s “Notify Payer” functionality
Web サイト
これが Yes に設定されると、買い手または支払者は PayPal からパッケージトラッキングの更新について通知を受けます。 オプション:Yes / No
NOTE
PayPal Credit または PayPal PayLater のいずれかを有効にできます。 両方のメソッドを同時に有効にすることはできません。

Styling

PayPal スタイル設定

フィールド
範囲
説明
Location
Web サイト
PayPal ボタンとメッセージがストアフロントでレンダリングされる場所を決定します。 オプション:Mini-Cart and Cart Page/Checkout Page/Product Page

Mini-Cart and Cart Page

このセクションのオプションと設定は、Location ​フィールドの設定によって異なります。

フィールド
範囲
説明
PayPal Button Type
Web サイト
Sets the button to one of three types: PayPal Button / PayPal Pay Later Button / PayPal Credit Button

PayPal Button

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

フィールド
範囲
説明
Show PayPal Button
Web サイト
選択した位置での PayPal ボタンの位置を決定します。 オプション:Yes / No
Button Label
Web サイト
Determines the label for the PayPal button. オプション:Paypal/Checkout/Buy Now/Pay
Color
Web サイト
PayPal ボタンの色を決定します。 オプション:Blue/Black/Gold/Silver
Shape
Web サイト
PayPal ボタンの形状を決定します。 オプション:Pill / Rectangle
Size(Deprecated)
Web サイト
PayPal ボタンのサイズを決定します。 オプション:Medium/Large/Responsive
NOTE
Size(Deprecated) 設定フィールドは非推奨となり、PayPal ボタンのスタイル設定には使用されません。

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

フィールド
範囲
説明
Apply
Web サイト
ボタンおよび PayLater メッセージング用に選択したスタイル設定を格納し、現在の場所および現在のボタンタイプに適用します。
Apply to All Buttons
Web サイト
ボタンと PayLater メッセージ 値に対して選択したスタイル設定を保存し、すべてのボタンの種類と場所に適用します。
Reset to Recommended Defaults
ウェブサイト
スタイル設定をボタンと PayLater メッセージの推奨される既定値に戻し、すべてのボタンの種類と場所に適用します。

Pay Later Messaging

Product Page

後で支払うメッセージング - 製品ページ

フィールド
範囲
説明
Show PayLater Messaging
Web サイト
選択した場所で PayLater メッセージを有効にします。 オプション:Yes/No。 使用可能なオファーに関する Pay Later メッセージを表示します。 制限事項があります。 詳しくは、ここをクリックしてください。
Message Layout
Web サイト
PayLater メッセージレイアウトを決定します。 オプション:Text / Flex
Logo
Web サイト
「後で支払う」メッセージに使用するロゴのタイプを決定します。 オプション:Inline/Primary/Alternative/None
Logo Position
Web サイト
「後で支払う」メッセージのロゴの位置を決定します。 オプション:Left/Right/Top
Text Color
ウェブサイト
後で支払う メッセージのテキストの色を決定します。 オプション:Black/White/Monochrome/Grayscale

Cart

Pay Later Messaging - Cart

フィールド
範囲
説明
Show PayLater Messaging
Web サイト
選択した場所で PayLater メッセージを有効にします。 オプション:Yes/No。 使用可能なオファーに関する Pay Later メッセージを表示します。 制限事項があります。 詳しくは、ここをクリックしてください。
Message Layout
Web サイト
PayLater メッセージレイアウトを決定します。 オプション:Text / Flex
Logo
Web サイト
「後で支払う」メッセージに使用するロゴのタイプを決定します。 オプション:Inline/Primary/Alternative/None
Logo Position
Web サイト
「後で支払う」メッセージのロゴの位置を決定します。 オプション:Left/Right/Top
Text Color
Web サイト
「後で支払う」メッセージのテキストカラーを決定します。 オプション:Black/White/Monochrome/Grayscale

Checkout

Pay Later Messaging - チェックアウト

フィールド
範囲
説明
Show PayLater Messaging
Web サイト
選択した場所で PayLater メッセージを有効にします。 オプション:Yes/No。 使用可能なオファーに関する Pay Later メッセージを表示します。 制限事項があります。 詳しくは、ここをクリックしてください。
Text Align
Web サイト
PayLater メッセージレイアウトを決定します。 オプション:Left/Center/Right
Text Color
Web サイト
「後で支払う」メッセージのテキストカラーを決定します。 オプション:Black / White

3d セキュア検証設定

3D セキュア検証設定

フィールド
範囲
説明
3D Secure Verification
Web サイト
顧客が VISA による検証 などのプログラムに登録されている場合、トランザクションが追加の検証プロセスをパスする必要があるかどうかを決定します。 オプション:Yes / No
Always request 3DS
Web サイト
すべてのトランザクションで常に3Dセキュアリクエストに挑戦します。 オプション: Yes / No
Threshold Amount
ウェブサイト
単一の注文での処理が許可されている最大注文額を決定します。 注文金額がこのしきい値の金額を超えると、Braintreeは認証を拒否します。
Verify for Applicable Countries
Web サイト
支払いを確認する必要がある国を決定します。 オプション:All Allowed Countries / Specific Countries
Verify for Specific Countries
Web サイト
該当する場合、Braintreeによる支払いを検証する必要がある具体的な国を特定します。

Dynamic Descriptors

動的記述子

フィールド
範囲
説明
Name
ストア表示
名前記述子には 2 つの部分があり、アスタリスク(*)で区切られています。 記述子の最初の部分は会社または DBA を示し、2 番目の部分は製品を示します。 例:company*myproduct

記述子の会社と製品の部分の長さは、次のように合計 22 文字まで割り当てることができます。
Option 1– 会社は 3 文字である必要があります/製品は 18 文字まで可能です
Option 2 – 会社は 7 文字である必要があります/製品は 14 文字まで可能です
Option 3– 会社は 12 文字である必要があります/製品は 9 文字まで可能です
Phone
ストア表示
Phone 記述子の長さは 10 ~ 14 文字で、数字、ダッシュ、括弧、ピリオドのみを使用できます。 例:9999999999 (999) 999-9999 999.999.9999
URL
ストア表示
URL 記述子はドメイン名を表し、最大 13 文字にすることができます。 例えば: company.com
recommendation-more-help
d39aca6f-58a0-41c6-83eb-39fd0ef30672