Braintree
作成対象:
- 初心者
- 中級
- 管理者
- ユーザー
Braintree offers a fully customizable checkout experience with fraud detection and PayPal integration. It supports Apple Pay, Google Pay, ACH, Venmo, and local payment methods. Braintree reduces the PCI compliance burden for merchants because the transaction takes place on the Braintree system. Braintree Payments の統合は、GENE Commerce によって開発されました。
-
管理者 サイドバーで、Stores/Settings/Configuration に移動します。
-
左側のパネルで「Sales」を展開し、「Payment Methods」を選択します。
-
Commerceのインストールに複数の web サイト、ストア、ビューがある場合は、左上隅で設定が適用される Store View を選択します。
-
Merchant Location セクションで、Merchant Country がビジネスの場所に設定されていることを確認します。
-
-
「Recommended Solutions」の「Braintree Payments (GENE Commerce v4.7.0 - リリースノート」セクションで、「Configure」をクリックします。
-
Title しくは、チェックアウト時にBraintreeを支払いオプションとして識別するタイトルを入力します。
-
Braintree取引の現在の営業 Environment を
Sandbox
またはProduction
に設定しますサンドボックスで設定をテストする場合は、Braintreeで推奨されている クレジットカード番号のみを使用します。 Braintreeを使用して実稼動に移行する準備が整ったら、Environment を
Production
に設定します。 -
Payment Action を次のいずれかに設定します。
Authorize Only
– 購入を承認し、資金を保留します。 加盟店が売却 キャプチャ するまで、お客様の銀行口座から金額は引き出されません。Intent Sale
– 購入金額は許可され、すぐにお客様のアカウントから引き出されます。 メモ: この値は、2.3.x 以前のリリースでは 認証してキャプチャ されていました。|
-
Braintree アカウントの Sandbox Merchant ID / Merchant ID を入力します。
-
Braintree アカウントから次の資格情報を入力します。
- Sandbox Public Key / Public Key
- Sandbox Private Key / Private Key
NOTE
(サンドボックスと実稼動)環境の両方に対して別々のフィールドがあり その他のフィールドは選択した環境に基づいてレンダリングされます。 -
設定を保存する前に、「Validate Credentials」をクリックして認証情報を検証します。
-
Enable Card Payments を
Yes
に設定します。 -
顧客情報を安全に保存する機能を希望し、顧客が購入するたびに情報を再入力する必要がない場合は、Enable Vault for Card Payments を
Yes
に設定します。 -
購入時にヴォールト・カードの CVV 番号を確認する場合は、Enable Vault CVV Re-verification を
Yes
に設定します。
手順 3:詳細設定の完了
-
「
-
Vault Title しくは、顧客カード情報が格納されている Vault を識別する、参照の説明的なタイトルを入力します。
-
Braintree アカウントの Merchant Account ID を入力します。
使用するマーチャントアカウントを指定しない場合、Braintreeはデフォルトのマーチャントアカウントを使用して取引を処理します。
-
PayPal、PayLater、Apple Pay、Google Pay など、チェックアウトプロセスの開始時に Express Payment オプションを使用して迅速にチェックアウトできるようにするために、Enable Checkout Express Payments を
Yes
に設定します。 -
高度な不正ツールのチェックの一環としてトランザクションが評価のために送信されないようにするには、管理者を通じて行われた注文で、Skip Fraud Checks on Admin Orders を
Yes
に設定します。 -
しきい値に達したとき、またはしきい値を超えたときに
Advanced Fraud Protection
チェックをバイパスするように、Bypass Fraud Protection Threshold を設定します。このフィールドを空白にすると、このオプションが無効になります。
-
ストアとBraintree間のやり取りのログファイルを保存する場合は、Debug を
Yes
に設定します。 -
クレジットカードの裏面から 3 桁のセキュリティコードを提供するよう顧客に求めるには、CVV Verification を
Yes
に設定します。CVV 検証を使用する場合は、Braintree アカウントの 設定/処理 セクションで AVS や CVV を必ず有効にしてください。
-
すべての支払い方法で買い物かご品目を送信するには、Send Card Line Items を
Yes
に設定します。 -
Credit Card Types しくは、Braintreeを通じて支払いとしてストアで受け入れられる各クレジットカードを選択します。
複数のカードの種類を選択するには、Ctrl キー(PC)または Command キー(Mac)を押したまま、各オプションをクリックします。
-
Sort Order しくは、番号を入力して、チェックアウト時に他のお支払い方法と一緒にリストされたときにBraintreeが表示される順序を指定します。
手順 4:Braintree Webhook を設定する
-
Enable Webhook を
Yes
に設定すると、不正防止、ACH 支払いおよびローカル支払い方法の Webhook 機能が有効になります。 -
「Fraud Protection URL」フィールドに URL をコピーし、Webhook Destination URL としてBraintree アカウントに追加します。
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 のリストが表示されます。 Hold down the Ctrl key (PC) or the Command key (Mac) and select each country in the list where customers can make purchases from your store.
-
To set up Country Specific Credit Card Types:
-
「Add」をクリックします。
-
Country を設定し、各 Allowed Credit Card Type を選択します。
-
繰り返して、各国から受け入れるクレジットカードを識別します。
-
手順 6:Braintreeを使用して ACH を実行する
-
Braintreeの支払いオプションとして ACH を含めるには、Enable ACH Direct Debit を
Yes
に設定します。 -
お客様は、1 回限りの ACH Direct Debit 支払い方法をヴォールティングし、将来の使用のために保存できます。 Once vaulted, customers can reuse ACH Direct Debit without needing to re-enter or authenticate their payment information if set Enable Vault for ACH Direct Debit to
Yes
. -
Sort Order:番号を入力して、チェックアウト時に他の支払い方法と一緒に表示されるBraintree ACH 支払い方法の順序を指定します。
手順 7:Braintreeを使用して Apple Pay を入力する
-
Braintreeの支払いオプションとして Apple Pay を含めるには、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
バンドルされたBraintree拡張機能は、Braintree開発者向けドキュメントにリストされているすべてのローカル支払い方法をサポートしているわけではありません。 今後のリリースでサポートされる予定の、その他の地域での支払い方法も開発中です。 -
Sort Order:番号を入力して、チェックアウト時に他の支払オプションとともに表示されるローカル支払方法の表示順序を決定します。
手順 9:Braintreeを使用して Google Pay を入力する
-
Braintreeの支払いオプションとして Google Pay を含めるには、Enable GooglePay Through Braintree を
Yes
に設定します。 -
お客様の情報を安全に保存し、Google Pay で購入するたびに情報を再入力する必要がない場合は、Enable Vault for GooglePay を
Yes
に設定します。 -
Payment Action を次のいずれかに設定します。
Authorize Only
– 購入を承認し、資金を保留します。 この金額は、マーチャントによって売却が キャプチャ されるまで、顧客の銀行口座から引き出されません。Intent Sale
– 購入金額は許可され、すぐにお客様のアカウントから引き出されます。
-
Google Pay ボタンの色を決定するには、Button Color を設定します:
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
に設定します。 -
顧客が今後のトランザクションで Venmo アカウントに再度ログインする必要がないように、セキュアなコンテナを使用して顧客の Venmo アカウントを保存できるようにするには、Enable Vault for Venmo を
Yes
に設定します。 -
Payment Action を次のいずれかに設定します。
Authorize Only
– 購入を承認し、資金を保留します。 この金額は、マーチャントによって売却が キャプチャ されるまで、顧客の銀行口座から引き出されません。Intent Sale
– 購入金額は許可され、すぐにお客様のアカウントから引き出されます。
-
Sort Order の場合は、番号を入力して、チェックアウト時に他の支払いオプションと一緒に表示される Venmo の表示順序を決定します。
手順 11:Braintreeで PayPal を入力
-
Braintreeの支払いオプションに PayPal を含めるには、Enable PayPal through Braintree を
Yes
に設定します。 -
Braintreeの支払い方法を使用して PayPal を指定します。
NOTE
PayPal Credit または PayPal PayLater のいずれかを有効にできます。 両方のメソッドを同時に有効にすることはできません。-
Braintreeの支払いオプションとして PayPal Credit を含めるには、Enable PayPal Credit through Braintree を
Yes
に設定します。When Enable PayPal through Braintree is set to
Yes
, only this field appears.NOTE
PayPal Credit is only available in the United States and United Kingdom. PayPal Credit is disabled if the selected value for the Merchant Country field is notUS
orUK
. -
Braintreeの支払いオプションとして PayPal PayLater を含めるには、Enable PayPal PayLater through Braintree を
Yes
に設定します。Enable PayPal PayLater through Braintree を
Yes
に設定すると、このフィールドのみが表示されます。3 で支払う などのオファーでは、サイトに PayLater メッセージを表示できます。この場合、顧客は 3 回の支払いを無利子で行うことができます。 Braintree統合では、この機能を宣伝するために、サイトにメッセージを表示できます。 PayLater オファーを、他のコンテンツ、マーケティングまたはマテリアルでプロモーションすることはできません。
-
-
Title しくは、チェックアウト時に「PayPal によるBraintree支払い」オプションを識別するタイトルを入力します。
-
Vault Enabled を
Yes
に設定すると、顧客の PayPal アカウントを保存するためのセキュアなコンテナを使用できるようになります。 ヴォールティングされた PayPal アカウントは、将来のトランザクションに使用でき、顧客のステップ数を減らすことができます。 -
Set Send Cart Line Items for PayPal to
Yes
to send the line items (order items) to PayPal along with Gift Cards, Gift Wrapping for items, Gift Wrapping for order, Store Credit, Shipping, and Tax as line items. -
For Sort Order, enter a number to determine the sequence in which the Braintree PayPal payment option appears when listed with other payment options during checkout.
-
ストア設定で定義した名前とは異なるマーチャント名を表示するには、表示したい名前を Override Merchant Name フィールドに入力します。
-
Payment Action を次のいずれかに設定します。
Authorize Only
– 購入を承認し、資金を保留します。 この金額は、マーチャントによって売却が キャプチャ されるまで、顧客の銀行口座から引き出されません。Authorize and Capture
– 購入金額は許可され、すぐにお客様のアカウントから引き出されます。
-
PayPal で処理されるBraintree トランザクションの場合は、Payment from Applicable Countries を次のいずれかに設定します。
All Allowed Countries
- ストア設定で指定されたすべての 国のお客様がこの支払い方法を使用できます。Specific Countries
– このオプションを選択すると、Payment from Specific Countries のリストが表示されます。 Ctrl キー(PC)または Command キー(Mac)を押しながら、リスト内で、お客様がストアから購入できる国を選択します。
-
顧客に請求先住所の指定を要求するには、Require Customer’s Billing Address を
Yes
に設定します。NOTE
この機能は、PayPal テクニカルサポートがお使いのアカウントで有効にする必要があります。 -
PayPal Express の注文レビューページをスキップするには、Skip Order Review Step を
Yes
に設定します。PayPal Express でお支払いのお客様の場合:お支払いを完了する前にお客様をレビューページにリダイレクトさせたい場合は、これを
No
に設定します。 顧客に対して、レビューページをスキップしたい場合は、レビューページをYes
に設定します。 -
Braintreeを使用してストアと PayPal 間のやり取りのログファイルを保存するには、Debug を
Yes
に設定します。 -
ミニカートと買い物かごページの両方に PayPal ボタンを表示するには、Display on Shopping Cart を
Yes
に設定します。 -
パッケージトラッキング情報を PayPal に送信するには、Send Package Tracking を
Yes
に設定します。パッケージトラッキング情報は、PayPal のトランザクション/注文の場合にのみ PayPal に送信されます。 Package Tracking 機能を正しく動作させるには、Send Cart Line Items for PayPal 設定フィールドを有効にする必要があります。
-
パッケージトラッキングの更新について PayPal で購入者または支払者に通知するには、Use PayPal’s “Notify Payer” functionality を
Yes
に設定します。
手順 12:スタイル設定を指定する
-
Location: PayPal ボタンとメッセージのレンダリング先を
Mini-Cart and Cart Page
、Checkout Page
、Product Page
から選択します
Mini-Cart and Cart Page
このセクションのオプションと設定は、「Location」フィールドの設定によって異なります。
- PayPal Button Type を、
PayPal Button
/PayPal Pay Later Button
/PayPal Credit Button
の 3 種類のボタンのいずれかに設定します。
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
)を選択します
これらのオプションを設定すると、PayPal ボタンのプレビューを確認できます。 設定の適用や値のリセットに使用できるコントロールがあります。
-
ボタンおよび PayLater メッセージング用に選択したスタイル設定を保存し、それらを現在の場所および現在のボタン タイプに適用するには、[Apply] をクリックします。
-
ボタンおよび PayLater メッセージング値に対して選択したスタイル設定を保存し、それらをボタンのすべてのタイプと場所に適用するには、[Apply to All Buttons] をクリックします。
-
スタイル設定をボタンと PayLater メッセージに推奨されるデフォルト値に戻し、すべてのボタンのタイプと場所に適用するには、[Reset to Recommended Defaults] をクリックします。
手順 13:後払いメッセージ
Product Page
-
製品ページのストアフロントに Pay Later のメッセージを表示するには、Show PayLater Messaging を
Yes
に設定します。使用可能なオファーに関する Pay Later メッセージを表示します。 制限事項があります。 PayPal のドキュメントを参照してください。
-
Message Layout の場合は、Pay Later のメッセージレイアウト(
Text
またはFlex
)を選択します。 -
Logo しくは、PayPal ロゴのタイプ(
Inline
、Primary
、Alternative
、None
のいずれか)を選択します -
Logo Position:PayPal ロゴの位置(
Left
、Right
、Top
のいずれか)を選択します -
Text Color の場合は、PayLater のメッセージのテキストの色を選択します(
Black
、White
、Monochrome
、Grayscale
)。
Cart
-
ストアフロントのミニカートまたはカートのページに Pay Later のメッセージを表示するには、Show PayLater Messaging を
Yes
に設定します。使用可能なオファーに関する Pay Later メッセージを表示します。 制限事項があります。 PayPal のドキュメントを参照してください。
-
Message Layout の場合は、Pay Later のメッセージレイアウト(
Text
またはFlex
)を選択します。 -
Logo しくは、PayPal ロゴのタイプ(
Inline
、Primary
、Alternative
、None
のいずれか)を選択します -
Logo Position:PayPal ロゴの位置(
Left
、Right
、Top
のいずれか)を選択します -
Text Color の場合は、PayLater のメッセージのテキストの色を選択します(
Black
、White
、Monochrome
、Grayscale
)。
Checkout
-
チェックアウト時にストアフロントに Pay Later のメッセージを表示するには、Show PayLater Messaging を
Yes
に設定します。使用可能なオファーに関する Pay Later メッセージを表示します。 制限事項があります。 PayPal のドキュメントを参照してください。
-
Text Align の場合、メッセージのテキストの位置揃え Pay Later 選択します(
Text
、Center
、Right
) -
Text Color の場合は、Pay Later メッセージのテキストの色
Black
、White
を選択します。
手順 14: 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)を押しながら、リスト内で、お客様がストアから購入できる国を選択します。
手順 15:Braintree動的記述子の設定
次の記述子は、顧客のクレジットカード明細書の購入を識別するために使用されます。 各購入に関連付けられている会社を明確に識別することで、チャージバックの数を減らすことができます。 動的記述子がアカウントで有効になっていない場合は、Braintree サポートにお問い合わせください。
-
次のガイドラインに従って、Name、Phone、URL の動的記述子を入力します。
-
Name – 名前記述子には 2 つの部分があり、アスタリスク(*)で区切られています。 例:
company*myproduct
記述子の最初の部分は会社または DBA を示し、2 番目の部分は製品を示します。 記述子の
company
とproduct
の部分の長さは、次のように、最大 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
-
-
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で配布されている拡張機能の設定が保持され、以前のバージョンで行われた支払いは通常どおりキャプチャ、無効化または払い戻しできます。