Skip to main content

​
概要

テストモードでは、実際の取引を処理せずに支払いをシミュレートできます。テスト用の認証情報はテストモードでのみ機能します。プロダクション環境では絶対に使用しないでください。

No Real Charges

テスト取引では実際の支払いは処理されず、実際のアカウントにも影響しません。

Full API Access

すべてのAPIエンドポイントは、テストモードとliveモードで同じように動作します。

Webhook Testing

Webhookはプロダクションと同様にテスト取引でも発生します。
テスト用の認証情報はテストモードでのみ機能します。liveモードで使用しようとすると、支払いが失敗します。

​
テストカード

以下のカード番号を使用して、さまざまな地域で成功する支払いと拒否される支払いをシミュレートします。
すべてのテストカードで、有効期限には06/32（または12/34）、CVVには123を使用してください。

​
Renewal Failureのテスト方法

1

Create a test subscription

successテストカード（例：4242 4242 4242 4242）を使用し、テスト用APIキーでサブスクリプションを作成します。初回の請求は成功し、サブスクリプションはactiveになります。
2

Swap in the failure card via Customer Portal

Customer Portalを開き、作成したサブスクリプションを見つけて、Update Payment Methodをクリックします。Failureテストカード4000 0000 0000 0341（有効期限：12/34、CVC：123）を入力し、サブスクリプションの支払い方法として保存します。
3

Advance the next billing date (optional)

自然な請求サイクルを待たずにすぐ更新をトリガーするには、Update Subscription APIを使用してnext_billing_dateを現在のUTC時刻に設定します。値はISO 8601 / RFC 3339形式のUTCタイムスタンプである必要があります（Zサフィックスが必須です）。
詳細については、Update Subscription API referenceを参照してください。
4

Verify the failure

次回の請求時：
  • Failureカードで更新請求が拒否される
  • サブスクリプションのステータスがOn-Holdに移行する
  • payment.failed Webhookイベントが配信される
  • 顧客はCustomer Portalに戻り、支払い方法を更新して再試行できる
このカードは更新の失敗をテストするための専用カードです。次回の請求日に請求が拒否されるため、支払いの再試行ロジック、顧客通知、失敗処理をテストできます。

​
テストUPI

UPIのテストでは、さまざまな支払い結果をシミュレートする特殊なVPA（Virtual Payment Address）識別子を使用します。

​
UPIテストの要件

  • 請求先の国はINに設定する必要があります
  • 通貨はINRである必要があります
  • インド以外のMerchantの場合：Adaptive Currencyを有効にする必要があります
サブスクリプションのRBI mandateテストを含むUPIの完全なドキュメントについては、India Payment Methodsページを参照してください。

​
テストBNPL

Buy Now Pay Laterプロバイダーには、特定のテストデータ要件があります。

​
Klarnaテストデータ

テストモードでKlarna支払いをシミュレートするには、以下の情報を使用します：
Klarnaを支払いオプションとして表示するには、最低取引金額**$50.01**が必要です。

​
Afterpayのテスト

1

Select Afterpay

Checkoutで支払い方法としてAfterpayを選択し、Payをクリックします。
2

Test successful payment

成功する支払いには、有効なEmailアドレスと配送先住所を使用してください。
3

Test failed authentication

失敗をシミュレートするには、リダイレクトページでAfterpayのモーダルウィンドウを閉じます。支払いは requires_customer_action から requires_payment_method に遷移します。
Afterpayを支払いオプションとして表示するには、最低取引金額**$50.01**が必要です。
Billie B2B testingを含む完全なBNPLドキュメントについては、Buy Now Pay Laterページをご覧ください。

​
デジタルウォレットのテスト

​
Apple Pay

1

Enable test mode

Dodo PaymentsのテストAPIキーを使用します。
2

Add a card to Apple Wallet

実際のカードをApple Walletに追加します。テストモードではカードに請求されません。
3

Complete test purchase

Appleデバイスでチェックアウトを開き、Apple Payのフローを完了します。
Apple PayにはHTTPSが必要です。適切なSSL設定がない場合、localhostには表示されません。ドメイン認証も完了している必要があります。

​
Google Pay

1

Join the test card group

テストカードを自動的にウォレットに追加するには、Google Payのテストカードグループに参加してください。
2

Enable test mode

Dodo PaymentsのテストAPIキーを使用します。
3

Complete test purchase

Google Payでテストカードのいずれかを選択して、取引を完了します。

​
Amazon Pay、Cash App Pay、RevolutPay

テストAPIキーを使用し、標準のチェックアウトフローに従います。テスト取引は実際の請求なしでシミュレーションされます。 Apple Payのドメイン認証を含む完全なデジタルウォレットのドキュメントについては、デジタルウォレットページをご覧ください。

​
ACH Direct Debit のテスト

チェックアウト時にテスト用の銀行情報を入力すると、Test Mode で ACH Direct Debit をテストできます。
1

Enable test mode

Dodo PaymentsのテストAPIキーを使用します。
2

Set currency and billing address

請求通貨を USD に設定し、請求先住所の国を US に設定してください。この組み合わせ以外では ACH は提供されません。
3

Use a one-time payment

ACH は subscription checkout では利用できないため、one-time payment に対してテストしてください。
4

Enter the test bank details

以下のテスト用 routing number と account number のペアのいずれかを入力し、webhook handler が最終的な支払いステータスを受信することを確認してください。ACH payments はチェックアウト時に確定するのではなく、非同期で確定します。

​
テスト用銀行口座

routing number 110000000 と以下のいずれかの account number を使用してください。 テスト用アカウントの全リストについては、ACH Direct Debit ページを参照してください。

​
European Methods のテスト

European payment methods（iDEAL、Bancontact、EPS、Multibanco）は、Test Mode でテストできます。
1

Enable test mode

Dodo Payments のテスト API keys を使用してください。
2

Set billing address

請求先住所の国を payment method に合わせて設定してください。
  • NL（iDEAL）
  • BE（Bancontact）
  • AT（EPS）
  • PT（Multibanco）
3

Set currency

European methods には EUR 通貨が必要です。
4

Complete test flow

test environment で simulated bank authentication flow に従ってください。

​
テスト用 SEPA Direct Debit IBAN

SEPA Direct Debit には EUR と Eurozone の請求先住所が必要です。特定の結果を発生させるには、以下のテスト用 IBAN を使用してください。 国ごとの値を含むテスト用 IBAN の全リストについては、Europe ページを参照してください。 European payment methods の完全なドキュメントについては、Europe ページを参照してください。

​
テストのベストプラクティス

成功する支払いだけをテストしないでください。declines、cancellations、残高不足などの edge cases もテストしてください。
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 を送信します
Apple Pay と Google Pay は、実際の iOS および Android デバイスでテストしてください。Simulator では wallet behavior を完全に再現できません。
Regional payment methods（UPI、iDEAL など）には、対応する請求先住所が必要です。請求先住所が米国の場合、iDEAL は表示されません。
BNPL methods には $50.01 以上の最低金額が必要です。cart total に応じて正しく表示または非表示になることをテストしてください。

​
関連ページ

Cards

カードのテスト、3D Secure、保存済みの payment methods。

Digital Wallets

Apple Pay、Google Pay、Amazon Pay のテスト。

BNPL

Klarna、Afterpay、Billie のテスト。

India

UPI と RBI mandate のテスト。

Europe

iDEAL、Bancontact、EPS、Multibanco のテスト。

Webhooks

test events 用の webhooks を設定します。

CLI Webhook Testing

Dodo Payments CLI を使用して、webhooks をローカルでテストします。
最終更新日 2026年8月17日