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– 購入金額が承認され、お客様のアカウントから直ちに引き落とされます。 Note:この値は、2.3.x以前のリリースの_認証とキャプチャ _でした。|
-
Braintree アカウントから Sandbox Merchant ID / Merchant ID を入力します。
-
Braintree アカウントから次の資格情報を入力します。
- Sandbox Public Key / Public Key
- Sandbox Private Key / Private Key
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に、顧客カード情報が保存されている保管スペースを識別する、参照用の説明的なタイトルを入力します。
-
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 アカウントのSettings/Processing セクションで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注文に割り当てられます。
-
Braintreeによって不正防止が拒否されるタイミングを判断するには、Fraud Protection Reject Order Status フィールドを設定します。
選択した注文ステータスは、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を実行する
-
ACHをBraintreeの支払いオプションとして含めるには、Enable ACH Direct Debitを
Yesに設定します。 -
顧客は、1回限りのACH ダイレクトデビット支払い方法を保管し、今後の使用に備えて保管することができます。 Enable Vault for ACH Direct Debitから
Yesに設定されている場合、顧客は支払い情報を再入力または認証する必要なく、ACH Direct Debitを再利用できます。 -
Sort Orderに番号を入力して、チェックアウト時に他の支払いオプションと共に表示されるBraintree ACH支払いオプションが表示される順序を決定します。
手順7: Braintreeの設定でApple Payを完了する
-
Apple PayをBraintreeの支払いオプションとして含めるには、Enable ApplePay through Braintreeを
Yesに設定します。最初に、Braintree アカウントで ドメイン名を確認してください。
-
お客様の情報を安全に保存する機能を使用して、お客様がApple Payで購入するたびに再入力する必要がない場合は、Enable Vault for ApplePayを
Yesに設定します。 -
Payment Actionを次のいずれかに設定します:
Authorize Only– 購入を承認し、資金を保留します。 金額は、販売者が販売を 獲得 するまで、顧客の銀行口座から引き出されません。Intent Sale– 購入金額が承認され、お客様のアカウントから直ちに引き落とされます。
-
Merchant Nameの場合、Apple支払いダイアログでお客様に表示されるラベルを指定するテキストを入力します。
-
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 バンドルされたBraintree拡張機能は、Braintree開発者ドキュメント に記載されているすべてのローカル支払い方法をサポートしていません。 その他のローカル支払い方法は、今後のリリースでサポートされる予定です。 -
Sort Orderに番号を入力して、チェックアウト中に他の支払いオプションと共に表示されるローカル支払い方法が表示される順序を決定します。
手順9: Braintreeの設定でGoogle Payを完了する
-
Google PayをBraintreeの支払いオプションとして含めるには、Enable GooglePay Through Braintreeを
Yesに設定します。 -
お客様の情報を安全に保存する機能を使用して、お客様がGoogle Payで購入するたびに再入力する必要がない場合は、Enable Vault for GooglePayを
Yesに設定します。 -
Payment Actionを次のいずれかに設定します:
Authorize Only– 購入を承認し、資金を保留します。 金額は、販売者が販売を 獲得 するまで、顧客の銀行口座から引き出されません。Intent Sale– 購入金額が承認され、お客様のアカウントから直ちに引き落とされます。
-
Button Colorを設定して、Google Pay ボタンの色を決定します:
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に設定します。 -
セキュリティで保護されたVaultを使用して顧客のVenmo アカウントを保存できるようにするには、Enable Vault for Venmoを
Yesに設定して、今後のトランザクションのために顧客がVenmo アカウントに再度ログインする必要がないようにします。 {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 PayPal Creditまたは PayPal PayLater を有効にできます。 両方のメソッドを同時に有効にすることはできません。 -
PayPal CreditをBraintreeの支払いオプションとして含めるには、Enable PayPal Credit through Braintreeを
Yesに設定します。Braintreeを通じてPayPalを有効にするが
Yesに設定されている場合、このフィールドのみが表示されます。note NOTE PayPal Creditは、米国および英国でのみ利用可能です。 Merchant Countryフィールドで選択した値が USまたはUKでない場合、PayPal クレジットは無効になります。 -
PayPal PayLaterをBraintreeの支払いオプションとして含めるには、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 アカウントは、今後の取引に使用できるため、顧客の手順数を減らすことができます。 -
Send Cart Line Items for PayPalから
Yesに設定して、行項目(注文項目)をギフトカード、項目のギフトラッピング、注文のギフトラッピング、店舗クレジット、配送、および行項目としての税金と共にPayPalに送信します。 -
「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 この機能は、PayPal テクニカルサポートによってアカウントに対して有効にする必要があります。 -
PayPal Expressの注文レビューページをスキップするには、Skip Order Review Stepを
Yesに設定します。PayPal Expressでお支払いのお客様:お支払いを完了する前にレビューページにリダイレクトする場合は、これを
Noに設定します。 お客様がレビューページをスキップする場合は、Yesに設定します。 -
ストアとPayPalのインタラクションのログファイルをBraintree経由で保存するには、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を3種類のボタンのいずれかに設定します:
PayPal Button/PayPal Pay Later Button/PayPal Credit Button
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に設定します。利用可能なオファーに対する後払いメッセージを表示します。 制限が適用されます。 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に設定します。利用可能なオファーに対する後払いメッセージを表示します。 制限が適用されます。 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に設定します。利用可能なオファーに対する後払いメッセージを表示します。 制限が適用されます。 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文字です。名前記述子の文字
Option 1 :
Companyは3文字である必要があります。Productは最大18文字ですOption 2 :
Companyは7文字である必要があります。Productは最大14文字ですオプション 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に配布された拡張機能の設定設定は保持され、以前のバージョンに配置された支払いは、引き続き通常どおりキャプチャ、無効化、または払い戻しできます。