Full API Access
Webhook Testing
Test Cards
これらのcard numberを使用して、さまざまな地域で成功および拒否される支払いをシミュレートします。- Successful Payments
- Declined Payments
- Subscription Renewal Failures
Testing Renewal Failures
1
Create a test subscription
成功用のtest card（例:
4242424242424242）を使用し、test API keyでsubscriptionを作成します。初回の請求は成功し、subscriptionはactiveになります。2
Update the payment method
Customer Portalを開いてsubscriptionを見つけ、Update Payment Methodをクリックします。failure test card
4000000000000341（Expiry: 12/34、CVV: 123）を入力して保存します。3
Advance the next billing date (optional)
自然なbilling cycleを待たずにすぐ更新を実行するには、Update Subscription APIを使用して詳細については、Update Subscription API referenceをご覧ください。
next_billing_dateを現在のUTC時刻に設定し、以下のexample valueを置き換えます。値はISO 8601 / RFC 3339 UTC timestampである必要があります（Z suffixは必須です）。4
Verify the failure
次回のbilling attemptでは、
- failure cardでrenewal chargeが拒否されます
- subscriptionはまずPast Due（grace period、
subscription.past_duewebhookにはpast_due_ends_atが含まれます）に移行し、grace period終了時にOn-Holdへ移行します payment.failedwebhook eventが配信されます- customerはCustomer Portalに戻り、payment methodを更新してretryできます
Test UPI
UPI testingでは、さまざまなpayment outcomeをシミュレートする特殊なVPA（Virtual Payment Address）identifierを使用します。Requirements for UPI Testing
- Billing countryは
INに設定する必要があります - Currencyは
INRである必要があります - インド以外のmerchantの場合: Adaptive Currencyを有効にする必要があります
Test Pix
Pix testingでは、QR code flowをシミュレートするためにtest CPF（Brazilian tax ID）を使用します。Requirements for Pix Testing
- Billing countryは
BRに設定する必要があります - Currencyは
BRLである必要があります
Test BNPL
Buy Now Pay Later providerには、固有のtest data要件があります。Klarna Test Data
これらのdetailsを使用して、test modeでKlarna paymentをシミュレートします。USD のチェックアウトでは、支払い方法として表示するために、Klarna は最低取引金額として $50.01 を要求します。
Afterpay Testing
1
Select Afterpay
checkoutでAfterpayをpayment methodとして選択し、Payをクリックします。
2
Test successful payment
成功するpaymentには、有効なemail addressとshipping addressを使用します。
3
Test failed authentication
failureをシミュレートするには、redirect pageでAfterpay modal windowを閉じます。paymentは
requires_customer_actionからrequires_payment_methodに移行します。USD のチェックアウトでは、支払い方法として表示するために、Afterpay は最低取引金額として $50.01 を要求します。
Test Digital Wallets
Apple Pay
1
Enable test mode
dashboard sidebarのLive Mode switchをオフにし、test modeで作成したAPI keyを使用します。Test Mode vs Live Modeをご覧ください。
2
Add a card to Apple Wallet
実際のcardをApple Walletに追加します。test modeではcardに請求されません。
3
Complete test purchase
Apple deviceでcheckoutを開き、Apple Pay flowを完了します。
Google Pay
1
Join the test card group
test cardをwalletに自動追加するには、Google Pay test card groupに参加してください。
2
Enable test mode
dashboard sidebarのLive Mode switchをオフにし、test modeで作成したAPI keyを使用します。Test Mode vs Live Modeをご覧ください。
3
Complete test purchase
Google Payでtest cardのいずれかを選択し、transactionを完了します。
Amazon Pay、Cash App Pay、RevolutPay
test API keyを使用し、標準のcheckout flowに従います。test transactionは実際の請求なしでシミュレートされます。 Apple Payのdomain verificationを含むデジタルウォレットの完全なdocumentationについては、Digital Walletsページをご覧ください。Test ACH Direct Debit
ACH Direct Debitは、checkoutでtest bank detailsを入力することでtest modeでテストできます。1
Enable test mode
dashboard sidebarのLive Mode switchをオフにし、test modeで作成したAPI keyを使用します。Test Mode vs Live Modeをご覧ください。
2
Set currency and billing address
billing currencyを
USDに、billing address countryをUSに設定します。この組み合わせ以外ではACHは提供されません。3
Use a one-time payment
ACHはsubscription checkoutでは利用できないため、one-time paymentに対してテストします。
4
Enter the test bank details
以下のtest routing and account number pairのいずれかを入力し、webhook handlerがfinal payment statusを受信することを確認します。ACH paymentはcheckout時ではなく、非同期で確定します。
Test Bank Accounts
routing number110000000と以下のaccount numberのいずれかを使用します。
test accountの完全な一覧については、ACH Direct Debitページをご覧ください。
Test European Methods
European payment methods（iDEAL、Bancontact、EPS、Multibanco）はtest modeでテストできます。Multibanco では、銀行フローの代わりにバウチャーが表示されます。Multibanco のテストを参照してください。
1
Enable test mode
ダッシュボードのサイドバーで Live Mode スイッチをオフにし、test mode で作成した API keys を使用します。Test Mode と Live Mode の比較を参照してください。
2
Set billing address
請求先住所の国を支払い方法に合わせて設定します。
NL（iDEAL の場合）BE（Bancontact の場合）AT（EPS の場合）PT（Multibanco の場合）
3
Set currency
欧州の支払い方法では EUR 通貨が必要です。
4
Complete test flow
test environment でシミュレートされた銀行認証フローに従います。
Multibanco のテスト
EUR とPT の請求先住所を使用します。Pay をクリックすると、チェックアウトに Multibanco のバウチャーが表示されます。test mode では、入力したメールアドレスによって結果が決まります。
成功ページを表示するには、
succeed_immediately@example.com を使用して数秒待ち、Done をタップします。
テスト用メールアドレスの全リストについては、欧州ページを参照してください。
SEPA Direct Debit のテスト用 IBAN
SEPA Direct Debit には EUR とユーロ圏の請求先住所が必要です。以下のテスト用 IBAN を使用して、特定の結果を発生させます。
国ごとの値を含むテスト用 IBAN の全リストについては、欧州ページを参照してください。
欧州の支払い方法に関する完全なドキュメントについては、欧州ページを参照してください。
アジア太平洋地域の Wallet のテスト
GCash、Alipay HK、FPS、Touch ‘n Go は QR code payments であり、請求先の国と通貨が一致する場合にのみ表示されます。1
Enable test mode
ダッシュボードのサイドバーで Live Mode スイッチをオフにし、test mode で作成した API keys を使用します。Test Mode と Live Mode の比較を参照してください。
2
Set billing country and currency
一致する組み合わせで one-time checkout を作成します。
3
Select the method and confirm
支払い方法を選択して Pay をクリックします。QR code が full-screen overlay で開き、チェックアウトは支払いを待機します。
4
Verify the checkout behavior
一致する国と通貨の場合にのみ支払い方法が表示され、QR code がレンダリングされることを確認します。
test-mode の QR codes は wallet provider の test environment によって発行されるため、live payment とは動作が異なる場合があります。
テストのベストプラクティス
Test all payment scenarios
Test all payment scenarios
成功する支払いだけをテストしないでください。declines、cancellations、残高不足などの edge cases をテストします。
Verify webhook handling
Verify webhook handling
webhook endpoints がすべての event types、特に
payment.succeeded、payment.failed、subscription events を正しく処理することを確認します。Dodo Payments CLI を使用して、webhooks をローカルでテストします。dodo wh listenは live test webhooks をローカルサーバーに転送しますdodo wh triggerはサポートされているすべての webhook event types の mock payloads を送信します
Test on real devices
Test on real devices
Apple Pay と Google Pay では、実際の iOS および Android devices でテストします。Simulators では wallet の動作を完全には再現できません。
Test regional methods with correct addresses
Test regional methods with correct addresses
Regional payment methods（UPI、iDEAL など）には、一致する請求先住所が必要です。米国の請求先住所では iDEAL は表示されません。
Verify minimum amounts
Verify minimum amounts
Klarna と Afterpay では、USD のチェックアウトに $50.01 の最低金額が必要です。カート合計額に基づいて正しく表示または非表示になることをテストします。