Braintree
Braintreeは、不正検知と PayPal 統合により、完全にカスタマイズ可能なチェックアウトエクスペリエンスを提供します。 Apple Pay、Google Pay、ACH、Venmo、およびローカルの支払い方法をサポートします。 BraintreeはBraintreeシステムで行われるので、マーチャントの PCI コンプライアンスに関する負担を軽減できます。 Braintreeペイメントの統合は、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.6.1 - リリースノート」セクションで、「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
に設定します。{width="600" modal="regular"}
顧客情報を安全に保存する機能を希望し、顧客が購入するたびに情報を再入力する必要がない場合は、Enable Vault for Card Payments を
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:BraintreeWebhook を設定する
-
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 を設定する
-
PayPal をBraintree付きの支払いオプションとして含めるには、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 の場合は、番号を入力して、チェックアウト時に他の支払い方法と一緒に表示されるBraintreePayPal 支払い方法の順序を指定します。
-
ストア設定で定義した名前とは異なるマーチャント名を表示するには、表示したい名前を 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 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
から選択します{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
)を選択します
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)を押しながら、リスト内で、お客様がストアから購入できる国を選択します。
{width="600" modal="regular"}
手順 14: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の主要な支払いバンドル拡張機能および拡張機能で配布されたCommerce Marketplaceが保持され、以前のバージョンで行われた支払いは、通常どおりキャプチャ、無効化または払い戻しできます。