Sales > Payment Methods > Braintree

IMPORTANT
Commerce 2.4 の移行:

Adobe CommerceおよびMagento Open Source 2.4.0 より前のバージョンの場合、マーチャントは、コア統合の代わりに、🔗0} Commerce Marketplaceから公式のBraintree支払い統合拡張機能をインストールして設定することをお勧めします。 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拡張機能を使用しない場合、マルチアドレス機能は、2.4.0 バージョンのBraintreeでは動作しません。 買い物客が 複数の住所に配信 を選択すると、Braintree支払い方法が表示されません。 2.3.x で以前に推奨したCommerce Marketplace拡張機能には、この複数のアドレスの問題があります。

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

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 とも呼ばれ、マーチャント ID は実稼動ゲートウェイとサンドボックスゲートウェイで異なります。 このフィールドは、「Environment」フィールドが「Sandbox」に設定されている場合に表示されます。
Sandbox Public Key
ストア表示
これは、暗号化されたデータへのアクセスを制限する、ユーザー固有の公開識別子です。 サンドボックスBraintreeゲートウェイに関連付けられた各ユーザーには、独自のサンドボックス公開鍵があります。 このフィールドは、「Environment」フィールドが「Sandbox」に設定されている場合に表示されます。
Sandbox Private Key
ストア表示
これは、暗号化されたデータへのアクセスを制限する、ユーザー固有のプライベート識別子です。 サンドボックスBraintreeゲートウェイに関連付けられた各ユーザーには、サンドボックス用の独自の秘密鍵があります。 このフィールドは、「Environment」フィールドが「Sandbox」に設定されている場合に表示されます。
Merchant ID
ストア表示
これは、ゲートウェイに存在する複数のマーチャントアカウントを含む、ゲートウェイアカウント全体の一意の ID です。 パブリック ID または 実稼動 ID とも呼ばれ、マーチャント ID は実稼動ゲートウェイとサンドボックスゲートウェイで異なります。 このフィールドは、「Environment」フィールドが「Production」に設定されている場合に表示されます。
Public Key
ストア表示
これは、暗号化されたデータへのアクセスを制限する、ユーザー固有の公開識別子です。 Braintreeゲートウェイに関連付けられた各ユーザーは、独自の公開鍵を持ちます。 このフィールドは、「Environment」フィールドが「Production」に設定されている場合に表示されます。
Private Key
ストア表示
これは、暗号化されたデータへのアクセスを制限する、ユーザー固有のプライベート識別子です。 Braintreeゲートウェイに関連付けられた各ユーザーは、独自の秘密鍵を持ちます。 このフィールドは、「Environment」フィールドが「Production」に設定されている場合に表示されます。
Enable Card Payments
Web サイト
Braintreeのクレジット カードによる支払い方法が、お客様の支払い方法として利用可能かどうかを判断します。 オプション:Yes / No
Enable Vault for Card Payments
Web サイト
有効にすると、は顧客の支払い情報を安全に保存できるので、顧客は購入ごとにクレジットカード情報を再入力する必要はありません。 オプション:Yes / No
Enable Vault CVV Reverification
Web サイト
有効化すると、Braintreeアカウントで設定された CVV ルールの検証が行われます。 オプション:Yes / No

Advanced Braintree Settings

Braintreeの詳細設定

フィールド
範囲
説明
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
Web サイト
チェックアウト時に他のお支払い方法と共にBraintreeがリストされる順序を指定します。

Braintree Webhooks Settings

Braintree Webhook の設定

フィールド
範囲
説明
Enable Webhook
Web サイト
詐欺保護、ACH 支払い、ローカル支払い方法、および紛争に対して Webhook 機能を有効にします。 オプション:Yes / No
Fraud Protection URL
Web サイト
この URL を Webhook Destination URL としてBraintreeアカウントに追加します。 この URL はセキュリティで保護され、公にアクセス可能である必要があります。
Fraud Protection Approve Order Status
Web サイト
不正防止がBraintreeによって承認されると、選択された注文ステータスがCommerce注文に割り当てられます。 このステータスは、ACH 支払い方法が使用されている注文のステータスと、Braintreeに移 SETTLED した注文のステータスを更新するために使用されます。
Fraud Protection Reject Order Status
Web サイト
Braintreeにより不正防止が拒否されると、選択された注文ステータスがCommerce注文に割り当てられます。 このステータスは、ACH 支払い方法が使用されている注文のステータスと、SETTLEMENT がBraintreeに DECLINED まれている注文のステータスを更新するために使用されます。

Country Specific Settings

国別設定

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

ACH through Braintree

Braintreeによる ACH

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

Apple Pay through Braintree

Apple ペイ スルーBraintree

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

GooglePay through Braintree

Braintreeによる GooglePay

フィールド
範囲
説明
Enabled GooglePay through Braintree
Web サイト
BraintreeGoogle Pay 支払い方法として支払いが含まれるかどうかを指定します。 オプション:Yes / No
Enable Vault for GooglePay
Web サイト
お客様は、今後の使用のために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

Braintreeによる Venmo

フィールド
範囲
説明
Enable Venmo through Braintree
Web サイト
Venmo がBraintreeによって支払い方法として含まれているかどうかを判断します。 オプション: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経由の PayPal

フィールド
範囲
説明
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 サイト
チェックアウト時に PayPal が他のお支払い方法と一緒にBraintreeされる順序を決定する数字です。
Override Merchant Name
ストア表示
各店舗表示の販売者を識別するために使用できる代替名。
Payment Action
Web サイト
支払い処理時にBraintreeを通じて PayPal が実行するアクションを指定します。 オプション:
Authorize– 顧客のカードの資金は許可されていますが、顧客のアカウントから転送されません。 注文はストア管理者で作成されます。 後で販売をキャプチャし、請求書を作成できます。
Authorize and Capture – お客様のカードの資金は、Braintreeを通じて PayPal によって承認および取得され、注文と請求書はストア管理者で作成されます。
Payment from Applicable Countries
Web サイト
PayPal で処理される支払いを、すべての国のBraintreeを通じて受け入れるか、特定の国のみから受け入れるかを指定します。 オプション:All Allowed Countries / Specific Countries
Payment from Specific Countries
Web サイト
該当する場合、はBraintreeによって処理される支払いを受け入れる特定の国を識別します。
Require Customer’s Billing Address
Web サイト
注文を送信するために顧客の請求先住所が必要かどうかを決定します。 オプション:Yes / No
Debug
Web サイト
Braintreeシステムを介した PayPal とストア間の通信がログファイルに記録されるかどうかを指定します。 オプション:Yes / No
Display on Shopping Cart
Web サイト
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 サイト
ボタンを PayPal Button/PayPal Pay Later Button/PayPal Credit Button の 3 つのタイプのいずれかに設定します。

PayPal Button

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

フィールド
範囲
説明
Show PayPal Button
Web サイト
選択した位置での PayPal ボタンの位置を決定します。 オプション:Yes / No
Button Label
Web サイト
PayPal ボタンのラベルを決定します。 オプション: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 ボタンのスタイル設定には使用されません。

PayLater Messaging

フィールド
範囲
説明
Show PayLater Messaging
Web サイト
選択した場所で PayLater メッセージを有効にします。 オプション:Yes/No。 有効化すると、利用可能なオファーに関する PayLater メッセージが表示されます( 制限あり)。
Message Layout
Web サイト
PayLater メッセージレイアウトを決定します。 オプション:Text / Flex
Logo
Web サイト
PayPal ボタンに使用するロゴのタイプを決定します。 オプション:Inline/Primary/Alternative/None
Logo Position
Web サイト
PayPal ボタンのロゴの位置を決定します。 オプション:Left/Right/Top
Text Color
Web サイト
PayPal ボタンのテキストカラーを決定します。 オプション:Black/White/Monochrome/Grayscale

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

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

3d セキュア検証設定

3D セキュア検証設定

フィールド
範囲
説明
3D Secure Verification
Web サイト
顧客が VISA による検証 などのプログラムに登録されている場合、トランザクションが追加の検証プロセスをパスする必要があるかどうかを決定します。 オプション:Yes / No
Always request 3DS
Web サイト
すべてのトランザクションに対して常に 3D Secure リクエストにチャレンジします。 オプション:Yes / No
Threshold Amount
Web サイト
単一の注文での処理が許可されている最大注文額を決定します。 注文金額がこのしきい値の金額を超えると、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