ACH Direct Debitを提供する理由
Lower Processing Cost
銀行引き落としは、特に高額注文の場合、通常カード決済よりも処理コストが低くなります。
No Card Required
銀行口座からの支払いを好む顧客や、高額購入でカードを使いたくない米国の顧客にも対応できます。
Higher Value Orders
カード決済に対するコスト面の優位性は注文額が大きいほど高まるため、ACHは高額なone-time purchasesに適しています。
概要
仕組み
顧客体験
- 顧客がcheckoutでACH Direct Debitを選択する
- 顧客が米国の銀行口座からの引き落としを承認する
- 支払いがACH networkに送信され、processing stateに移行する
- その後のbusiness daysにわたってclearingが完了する
- 支払いがsucceeded stateに移行するか、銀行によって返却された場合は失敗する
clearingは非同期で行われるため、最終結果を確認するにはcheckout redirectではなくwebhooksを使用してください。redirectが成功したことは、顧客が引き落としを承認したことだけを意味します。引き落としが送信されると、支払いは
payment.processingを発行し、clearingが完了するとpayment.succeededまたはpayment.failedを発行します。履行を実行して安全なのはpayment.succeededのみです。利用条件
ACH Direct Debitは、次のすべての条件を満たす場合にcheckoutに表示されます。- 請求通貨が
USDである - 請求先国が
USである - 取引がone-time paymentである
ACH Direct Debitはsubscriptionsでは利用できません。複数日にわたるclearing windowは、recurring billing cyclesには適していません。recurring paymentsには、cardsまたはsubscriptionsに対応する別のmethodを使用してください。Payment Methods overviewを参照してください。
設定
ACH Direct Debitには、USDのbilling currencyと、USのbilling addressが必要です。別の通貨で価格を提示している場合は、Adaptive Currencyを有効にして、米国の顧客への請求をUSDにすると、ACHを利用できるようになります。
API Method Type
RefundsとDisputes
ACH paymentsのRefundsとdisputesには、他のすべてのpayment methodsと同じAPIとdashboard flowsを使用します。実装するACH-specific handlingはありません。テスト
1
Enable test mode
Dodo Paymentsのtest API keysを使用してください。
2
Set currency and billing address
billing currencyを
USDに設定し、billing addressのcountryをUSに設定します。3
Include `ach` in allowed methods
allowed_payment_method_typesにachを渡すか、対象となるすべてのmethodを表示するにはfieldを完全に省略します。4
Enter the test bank details
以下のtest routing and account number pairsのいずれかを入力し、webhook handlerが最終的なpayment statusを受信することを確認します。
テスト用銀行口座
顧客はcheckoutでaccount numberとrouting numberを直接入力します。test modeでは、特定の結果を発生させるために、routing number110000000と以下のaccount numbersのいずれかを使用します。
ほとんどのtest paymentsは、実際のclearing windowよりもはるかに早く最終statusに到達するため、integrationの検証に数日待つ必要はありません。例外は
000000000009で、processing状態が続くよう設計されています。ベストプラクティス
Set customer expectations at checkout
Set customer expectations at checkout
銀行決済は即時にはclearingされないことを顧客に伝えてください。これにより、注文がまだpendingである理由を尋ねるサポートチケットを減らせます。
Provide card fallbacks
Provide card fallbacks
achと併せて、常にcreditおよびdebitを含めてください。これにより、商品への即時アクセスが必要な顧客が、より速いmethodを選択できます。Use ACH for high-value one-time purchases
Use ACH for high-value one-time purchases
ACHのコスト面の優位性は注文額が大きいほど高まるため、小額の購入よりも高額なone-time purchasesで最も有効です。
トラブルシューティング
ACH not appearing at checkout
ACH not appearing at checkout
確認項目:
- billing currencyは
USDに設定されていますか？ - 顧客のbilling countryは
USですか？ achはallowed_payment_method_typesに含まれていますか？- one-time paymentですか？ACHはsubscriptionsでは提供されません。
allowed_payment_method_typesを一時的に削除して、対象となるすべてのmethodを表示します。その後、API requestでbilling currencyとaddress countryを確認してください。ACH not appearing on a subscription checkout
ACH not appearing on a subscription checkout
原因: ACH Direct Debitはone-time paymentsでのみ提供されます。解決策: recurring billingには、cardsまたは別のsubscription-capable methodを使用してください。
Payment stuck in processing
Payment stuck in processing
原因: これは想定された動作です。ACH paymentsはclearing window全体にわたってprocessing stateに留まるため、カード決済よりもはるかに時間がかかります。解決策: 最終webhookを待ってください。paymentを再試行しないでください。再試行すると、顧客に二重に請求される可能性があります。
Payment failed after initially succeeding at checkout
Payment failed after initially succeeding at checkout
原因: 顧客の銀行が引き落としを返却しました。最も一般的な原因は残高不足または口座の閉鎖です。解決策: paymentを失敗として扱い、別のpayment methodで再試行するよう顧客に依頼してください。これを避けるため、必ずsucceeded stateを条件に履行を実行してください。
関連ページ
Payment Methods Overview
対応しているすべてのpayment methodsを確認します。
Adaptive Currency
通貨の対応状況と自動換算。
Checkout Guide
checkoutの完全な実装ガイド。
Webhooks
遅延するpayment confirmationsを非同期で処理します。