Braintree
Braintreeは、不正検知と PayPal 統合により、完全にカスタマイズ可能なチェックアウトエクスペリエンスを提供します。 Apple Pay、Google Pay、ACH、Venmo、およびローカルの支払い方法をサポートします。 BraintreeではBraintree システム上で取引が行われるので、マーチャントの PCI コンプライアンスに関する負担が軽減されます。 Braintree Payments の統合は、GENE Commerce によって開発されました。
手順 1:Braintree資格情報を取得する
Braintree支払いに移動してアカウントに新規登録します。
手順 2:基本設定を完了する
-
管理者 サイドバーで、Stores/Settings/Configuration に移動します。
-
左側のパネルで「Sales」を展開し、「Payment Methods」を選択します。
-
Commerceのインストールに複数の web サイト、ストア、ビューがある場合は、左上隅で設定が適用される Store View を選択します。
-
Merchant Location セクションで、Merchant Country がビジネスの場所に設定されていることを確認します。
-
-
「Recommended Solutions」の「Braintree Payments (GENE Commerce v4.7.0 - リリースノート 」セクションで、「Configure」をクリックします。
{width="600" modal="regular"}
-
Title しくは、チェックアウト時にBraintreeを支払いオプションとして識別するタイトルを入力します。
-
Braintree取引の現在の営業 Environment を
SandboxまたはProductionに設定しますサンドボックスで設定をテストする場合は、Braintreeで推奨されている クレジットカード番号のみを使用します。 Braintreeを使用して実稼動に移行する準備が整ったら、Environment を
Productionに設定します。 {width="600" modal="regular"}
-
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 note NOTE (サンドボックスと実稼動)環境の両方に対して別々のフィールドがあり その他のフィールドは選択した環境に基づいてレンダリングされます。 -
設定を保存する前に、「Validate Credentials」をクリックして認証情報を検証します。
-
Enable Card Payments を
Yesに設定します。 -
顧客情報を安全に保存する機能を希望し、顧客が購入するたびに情報を再入力する必要がない場合は、Enable Vault for Card Payments を
Yesに設定します。 -
購入時にヴォールト・カードの CVV 番号を確認する場合は、Enable Vault CVV Re-verification を
Yesに設定します。
手順 3:詳細設定の完了
-
「
」を展開し、「Advanced Braintree Settings」セクションを展開します。
{width="550" modal="regular"}
-
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 アカウントに追加します。
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)を押しながら、リスト内で、お客様がストアから購入できる国を選択します。
{width="600" modal="regular"}
-
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 支払い方法をヴォールティングし、将来の使用のために保存できます。 ヴォールト後、お客様は ACH Direct Debit を再利用できます。
Yesに設定されている場合は、支払い情報を再入力または認証する必要は Enable Vault for ACH Direct Debit りません。 -
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(まだサポートされていません) {width="600" modal="regular"}
note note 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に設定します。 {width="600" modal="regular"}
-
Payment Action を次のいずれかに設定します。
Authorize Only– 購入を承認し、資金を保留します。 この金額は、マーチャントによって売却が キャプチャ されるまで、顧客の銀行口座から引き出されません。Intent Sale– 購入金額は許可され、すぐにお客様のアカウントから引き出されます。
-
Sort Order の場合は、番号を入力して、チェックアウト時に他の支払いオプションと一緒に表示される Venmo の表示順序を決定します。
手順 11:Braintreeで PayPal を入力
-
Braintreeの支払いオプションに PayPal を含めるには、Enable PayPal through Braintree を
Yesに設定します。 -
Braintreeの支払い方法を使用して PayPal を指定します。
note note NOTE PayPal Credit または PayPal PayLater のいずれかを有効にできます。 両方のメソッドを同時に有効にすることはできません。 -
Braintreeの支払いオプションとして PayPal Credit を含めるには、Enable PayPal Credit through Braintree を
Yesに設定します。Braintreeで PayPal を有効にする が
Yesに設定されている場合、このフィールドのみが表示されます。note note NOTE PayPal クレジットは米国および英国でのみ利用できます。 Merchant Country フィールドに選択した値が USまたはUKでない場合、PayPal クレジットは無効になります。 -
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 アカウントは、将来のトランザクションに使用でき、顧客のステップ数を減らすことができます。 -
行項目(注文項目)を PayPal に送信し、ギフトカード、商品のギフトラッピング、注文のギフトラッピング、ストアクレジット、配送、税を行項目として送信するには、Send Cart Line Items for PayPal を
Yesに設定します。 -
Sort Order しくは、数字を入力して、チェックアウト時に他の支払いオプションと一緒に表示されるBraintree PayPal 支払いオプションの表示順序を指定します。
-
ストア設定 で定義した名前とは異なるマーチャント名を表示するには、表示したい名前を 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)を押しながら、リスト内で、お客様がストアから購入できる国を選択します。
{width="550" modal="regular"}
-
顧客に請求先住所の指定を要求するには、Require Customer’s Billing Address を
Yesに設定します。note note 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から選択します {width="600" modal="regular"}
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)を押しながら、リスト内で、お客様がストアから購入できる国を選択します。
{width="600" modal="regular"}
手順 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-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)をアンインストールして、Magento_Braintree の代わりに PayPal_Braintree 名前空間を使用するようにコードのカスタマイズを更新する必要があります。 コアバージョンのCommerce Braintree Payments バンドル拡張機能およびCommerce Marketplaceで配布されている拡張機能の設定が保持され、以前のバージョンで行われた支払いは通常どおりキャプチャ、無効化または払い戻しできます。