Zum Hauptinhalt springen

​
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 credentials only work in test mode. Attempting to use them in live mode will result in payment failures.

​
Test Cards

Use these card numbers to simulate successful and declined payments across different regions.
Für alle Testkarten verwenden Sie das Ablaufdatum 06/32 (oder 12/34) und CVV 123.

​
Wie man Erneuerungsausfälle testet

1

Create a test subscription

Erstellen Sie ein Abonnement mit Ihren Test-API-Schlüsseln unter Verwendung einer erfolgreichen Testkarte (zum Beispiel, 4242 4242 4242 4242). Die anfängliche Belastung sollte gelingen und das Abonnement sollte aktiv werden.
2

Swap in the failure card via Customer Portal

Öffnen Sie das Kundenportal, finden Sie das Abonnement, das Sie gerade erstellt haben, und klicken Sie auf Zahlungsmethode aktualisieren. Geben Sie die Fehlertestkarte 4000 0000 0000 0341 ein (Ablaufdatum: 12/34, CVC: 123) und speichern Sie sie als Zahlungsart des Abonnements.
3

Advance the next billing date (optional)

Um die Erneuerung sofort auszuführen, anstatt auf den natürlichen Abrechnungszyklus zu warten, verwenden Sie die Update Subscription API, um next_billing_date auf die aktuelle UTC-Zeit einzustellen. Der Wert muss einen ISO 8601 / RFC 3339 UTC-Zeitstempel (der Z Suffix ist erforderlich) enthalten.
Siehe die Update Subscription API Referenz für Details.
4

Verify the failure

Beim nächsten Abrechnungsversuch:
  • Die Erneuerungsbelastung wird auf der Fehlerkarte abgelehnt
  • Das Abonnement wechselt in den Status On-Hold
  • Ein payment.failed Webhook-Ereignis wird gesendet
  • Der Kunde kann zum Kundenportal zurückkehren, um die Zahlungsmethode zu aktualisieren und es erneut zu versuchen
Diese Karte ist speziell zum Testen von Erneuerungsausfällen gedacht. Die Belastung wird am nächsten Abrechnungsdatum abgelehnt, sodass Sie die Zahlungswiederholungslogik, Kundenbenachrichtigungen und das Fehlermanagement testen können.

​
UPI testen

UPI-Tests verwenden spezielle VPA (Virtual Payment Address) Kennungen, die verschiedene Zahlungsergebnisse simulieren.

​
Anforderungen für UPI-Tests

  • Das Abrechnungsland muss auf IN eingestellt sein
  • Die Währung muss INR sein
  • Für Nicht-Indische Händler: Adaptive Currency muss aktiviert sein
Für vollständige UPI-Dokumentation, einschließlich der RBI-Mandatstests für Abonnements, siehe die Seite Indische Zahlungsmethoden.

​
BNPL testen

Buy Now Pay Later-Anbieter haben spezifische Testdatenanforderungen.

​
Klarna Testdaten

Verwenden Sie diese Details, um Klarna-Zahlungen im Testmodus zu simulieren:
Klarna verlangt eine Mindesttransaktionssumme von $50.01, um als Zahlungsoption angezeigt zu werden.

​
Afterpay Testing

1

Select Afterpay

Wählen Sie Afterpay als Zahlungsmethode im Checkout und klicken Sie auf Bezahlen.
2

Test successful payment

Verwenden Sie eine gültige E-Mail-Adresse und Versandadresse für erfolgreiche Zahlungen.
3

Test failed authentication

Um einen Ausfall zu simulieren, schließen Sie das Afterpay-Modalfenster auf der Weiterleitungsseite. Die Zahlung wechselt von requires_action zu requires_payment_method.
Afterpay verlangt eine Mindesttransaktionssumme von $50.01, um als Zahlungsoption angezeigt zu werden.

​
Sunbit Testing

1

Set billing country and currency

Stellen Sie sicher, dass billing_address.country US ist und billing_currency USD ist.
2

Use a qualifying amount

Setzen Sie den Transaktionsbetrag zwischen 60.00und60.00 und 19,999.00.
3

Complete the Sunbit flow

Wählen Sie Sunbit beim Checkout und vervollständigen Sie die Finanzierungsanwendung im Sunbit-Modal.
4

Test failure

Schließen Sie das Sunbit-Modal, bevor der Ablauf abgeschlossen ist, um eine abgelehnte Anwendung zu simulieren. Die Zahlung wechselt zu requires_payment_method.
Sunbit erscheint nur für US-Kunden, die in USD mit einem Betrag zwischen 60.00∗∗und∗∗60.00** und **19,999.00 zahlen.
Für vollständige BNPL-Dokumentation, einschließlich Billie B2B-Tests, siehe die Seite Buy Now Pay Later.

​
Digitale Wallets testen

​
Apple Pay

1

Enable test mode

Verwenden Sie Ihre Dodo Payments Test-API-Schlüssel.
2

Add a card to Apple Wallet

Fügen Sie eine echte Karte zu Ihrem Apple Wallet hinzu. Im Testmodus wird die Karte nicht belastet.
3

Complete test purchase

Öffnen Sie den Checkout auf einem Apple-Gerät und führen Sie den Apple Pay-Ablauf durch.
Apple Pay erfordert HTTPS. Es wird nicht auf localhost ohne ordnungsgemäße SSL-Einrichtung angezeigt. Die Domain-Überprüfung muss ebenfalls abgeschlossen sein.

​
Google Pay

1

Join the test card group

Treten Sie der Google Pay Testkarten-Gruppe bei, um Testkarten automatisch zu Ihrem Wallet hinzuzufügen.
2

Enable test mode

Verwenden Sie Ihre Dodo Payments Test-API-Schlüssel.
3

Complete test purchase

Wählen Sie eine der Testkarten in Google Pay, um die Transaktion abzuschließen.

​
Amazon Pay, Cash App Pay & RevolutPay

Verwenden Sie Ihre Test-API-Schlüssel und folgen Sie dem Standard-Checkout-Ablauf. Testtransaktionen werden simuliert, ohne dass tatsächliche Gebühren erhoben werden. Für vollständige Dokumentation zu digitalen Wallets, einschließlich der Domain-Verifizierung für Apple Pay, siehe die Seite Digitale Wallets.

​
Europäische Methoden testen

Europäische Zahlungsmethoden (iDEAL, Bancontact, EPS, Multibanco) können im Sandboxmodus getestet werden.
1

Enable test mode

Verwenden Sie Ihre Dodo Payments Test-API-Schlüssel.
2

Set billing address

Setzen Sie das Land der Rechnungsadresse so, dass es zur Zahlungsmethode passt:
  • NL für iDEAL
  • BE für Bancontact
  • AT für EPS
  • PT für Multibanco
3

Set currency

Europäische Methoden erfordern EUR als Währung.
4

Complete test flow

Befolgen Sie den simulierten Bankauthentifizierungsablauf in der Testumgebung.
Für vollständige Dokumentation zu europäischen Zahlungsmethoden, siehe die Seite Europa.

​
Testen Sie Best Practices

Testen Sie nicht nur erfolgreiche Zahlungen. Testen Sie Ablehnungen, Stornierungen und Grenzfälle wie unzureichende Mittel.
Stellen Sie sicher, dass Ihre Webhook-Endpunkte alle Ereignistypen korrekt verarbeiten, insbesondere payment.succeeded, payment.failed und Abonnementereignisse.Verwenden Sie das Dodo Payments CLI, um Webhooks lokal zu testen:
  • dodo wh listen leitet Live-Test-Webhooks an Ihren lokalen Server weiter
  • dodo wh trigger sendet Mock-Payloads für alle 22 Ereignistypen
Für Apple Pay und Google Pay testen Sie auf tatsächlichen iOS- und Android-Geräten. Simulatoren replizieren das Wallet-Verhalten nicht vollständig.
Regionale Zahlungsmethoden (UPI, iDEAL, etc.) erfordern übereinstimmende Rechnungsadressen. Eine US-Rechnungsadresse zeigt iDEAL nicht an.
BNPL-Methoden erfordern $50.01 Minimum. Testen Sie, dass sie korrekt angezeigt/versteckt werden basierend auf dem Gesamtwert des Warenkorbs.

​
Verwandte Seiten

Cards

Kartentest, 3D Secure und gespeicherte Zahlungsmethoden.

Digital Wallets

Apple Pay, Google Pay, Amazon Pay Tests.

BNPL

Klarna, Afterpay und Billie Tests.

India

UPI- und RBI-Mandatstests.

Europe

iDEAL, Bancontact, EPS, Multibanco Tests.

Webhooks

Richten Sie Webhooks für Testereignisse ein.

CLI Webhook Testing

Testen Sie Webhooks lokal mit dem Dodo Payments CLI.
Zuletzt geändert am 18. Juni 2026