Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Test mode lets you simulate payments without processing real transactions. All test credentials only work in test mode — never use them in production.No Real Charges
Test transactions don’t process actual payments or affect real accounts.
Full API Access
All API endpoints work identically in test and live modes.
Webhook Testing
Webhooks fire for test transactions just like production.
Test Cards
Use these card numbers to simulate successful and declined payments across different regions.- Successful Payments
- Declined Payments
- Subscription Failure Testing (Renewal/Upgrade/Downgrade)
| Region | Brand | Card Number | Expiry | CVV |
|---|---|---|---|---|
| US | Visa | 4242424242424242 | 06/32 | 123 |
| US | Mastercard | 5555555555554444 | 06/32 | 123 |
| India | Visa | 4576238912771450 | 06/32 | 123 |
| India | Mastercard | 5409162669381034 | 06/32 | 123 |
すべてのテストカードについて、有効期限 06/32（または 12/34）および CVV 123 を使用してください。
更新失敗のテスト方法
Create a test subscription
テストAPIキーを使用して、成功 テストカード（例：
4242 4242 4242 4242）でサブスクリプションを作成します。最初の請求は成功し、サブスクリプションはアクティブになります。Swap in the failure card via Customer Portal
Customer Portal を開き、作成したサブスクリプションを見つけて、Update Payment Method をクリックします。失敗テストカード
4000 0000 0000 0341（有効期限: 12/34、CVC: 123）を入力し、それをサブスクリプションの支払い方法として保存します。Advance the next billing date (optional)
自然な請求サイクルを待つ代わりに更新を即座にトリガーするには、Update Subscription APIを使用して、詳細については、Update Subscription API リファレンスを参照してください。
next_billing_dateを現在のUTC時間に設定します。この値はISO 8601 / RFC 3339 UTCタイムスタンプである必要があります（Z接尾辞が必要です）。UPI のテスト
UPIテストでは、さまざまな支払い結果をシミュレートする特別なVPA（仮想支払いアドレス）識別子を使用します。| ステータス | UPI ID |
|---|---|
| 成功 | success@upi |
| 失敗 | failure@upi |
UPIテストの要件
- 請求国は
INに設定する必要があります - 通貨は
INRである必要があります - インド以外の商人に対しては、Adaptive Currencyを有効にする必要があります
BNPLのテスト
Buy Now Pay Laterプロバイダーには特定のテストデータ要件があります。Klarna テストデータ
Klarnaの支払いをテストモードでシミュレートするには、次の詳細を使用します。| フィールド | 承認済み | 拒否されました |
|---|---|---|
| 生年月日 | 07-10-1970 | 07-10-1970 |
| 名前 | テスト | テスト |
| 姓 | Person-us | Person-us |
| メール | customer@email.us | customer+denied@email.us |
| 通り | Amsterdam Ave | Amsterdam Ave |
| 番地 | 509 | 509 |
| 市 | New York | New York |
| 州 | New York | New York |
| 郵便番号 | 10024-3941 | 10024-3941 |
| 電話 | +13106683312 | +13106354386 |
Klarnaは、$50.01 以上の取引金額で支払いオプションとして表示されます。
Afterpay テスト
Afterpayは、$50.01 以上の取引金額で支払いオプションとして表示されます。
デジタルウォレットのテスト
Apple Pay
Google Pay
Join the test card group
Google Pay のテストカードグループに参加して、テストカードが自動的にウォレットに追加されるようにします。
Amazon Pay、Cash App Pay & RevolutPay
テストAPIキーを使用し、標準のチェックアウトフローに従ってください。テストトランザクションは実際の請求なしにシミュレートされます。 Apple Pay のドメイン検証を含む完全なデジタルウォレットドキュメントについては、Digital Wallets ページを参照してください。ヨーロッパのメソッドのテスト
ヨーロッパの支払い方法（iDEAL、Bancontact、EPS、Multibanco）はサンドボックスモードでテストできます。
ヨーロッパの支払い方法ドキュメント全体については、Europeページを参照してください。
テストのベストプラクティス
Test all payment scenarios
Test all payment scenarios
成功した支払いだけでなく、拒否、キャンセル、および不足資金のようなエッジケースもテストしてください。
Verify webhook handling
Verify webhook handling
Webhook エンドポイントが特に
payment.succeeded、payment.failed、およびサブスクリプションイベントのすべてのイベントタイプに正しく処理することを確認してください。Dodo Payments CLI を使用してローカルで Webhooks をテストします：dodo wh listenはライブテスト Webhooks をローカルサーバーへ転送しますdodo wh triggerはすべての22のイベントタイプのモックペイロードを送信します
Test on real devices
Test on real devices
Apple Pay と Google Pay は、実際の iOS や Android デバイスでテストしてください。シミュレータではウォレットの動作を完全に再現できません。
Test regional methods with correct addresses
Test regional methods with correct addresses
地域支払い方法（UPI、iDEAL など）は、請求住所との一致が必要です。米国の請求住所では iDEAL が表示されません。
Verify minimum amounts
Verify minimum amounts
BNPL メソッドは $50.01 以上が必要です。カートの合計に基づいて正しく表示または非表示になることをテストしてください。
関連ページ
Cards
カードテスト, 3D セキュア, 保存された支払い方法。
Digital Wallets
Apple Pay, Google Pay, Amazon Payテスト。
BNPL
Klarna, Afterpay, Billieテスト。
India
UPIとRBI命令テスト。
Europe
iDEAL, Bancontact, EPS, Multibancoテスト。
Webhooks
テストイベント用のWebhooksを設定します。
CLI Webhook Testing
Dodo Payments CLIでローカルにWebhookをテストします。