SDKs & Libraries
Offizielle Backend-SDKs für TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby und Rust. Diese Bibliotheken vereinfachen API requests, authentication und error handling, sodass du dich auf die Entwicklung hervorragender Zahlungserlebnisse konzentrieren kannst.
Mobile Checkout SDKs
Du entwickelst eine native App? Öffne den gehosteten Checkout von Dodo und erhalte mit einem einzigen Aufruf ein typisiertes Ergebnis – für Android, iOS, React Native und Flutter. Diese benötigen keinen API key.
Umgebungs-URLs
- Test Mode:
https://test.dodopayments.com - Live Mode:
https://live.dodopayments.com
Erfahre mehr über Test Mode vs Live Mode.
API-Key-Verwaltung und authentication
1
Access API Keys
Navigiere in deinem Dashboard zu Developer → API Keys, um deine keys zu verwalten.
2
Generate a New Key
Wähle Add API Key, gib einen aussagekräftigen Namen ein und konfiguriere den Schreibzugriff:
- Enable write access (aktiviert): Vollständige Lese- und Schreibberechtigungen für alle API operations
- Enable write access (deaktiviert): Read-only-Zugriff – Daten können nur abgerufen werden (payments, subscriptions, customers, products). Ressourcen können nicht erstellt oder geändert werden.
3
Store Your Key Securely
Kopiere den generierten key sofort und stelle sicher, dass er sicher gespeichert wird.
4
Authenticate Your API Requests
Verwende deine API keys, um alle requests zu authentifizieren. Nutze das folgende authorization-Format:
Antwortformat
Ratenlimits
Unsere API verwendet ein Ratenbegrenzungssystem mit zwei Zeitfenstern und Burst-Schutz. Die Limits richten sich nach deiner authentication-Methode und deinem business tier.Standardlimits (Tier 0)
Business-Tiers
Höhere Ratenlimits sind für Unternehmen mit erhöhtem API-Bedarf verfügbar:Nicht authentifizierte requests
Requests ohne gültige authentication headers werden nach IP-Adresse begrenzt:Ratenlimit-Header
Überwache deine Nutzung mit diesen response headers:X-RateLimit-Limit– Maximale Anzahl zulässiger requestsX-RateLimit-Remaining– Verbleibende requests im aktuellen ZeitfensterX-RateLimit-Reset– Zeitpunkt, an dem das Ratenlimit zurückgesetzt wird
Wenn du die Ratenlimits überschreitest, gibt die API eine
429 Too Many Requests response zurück. Implementiere exponentielles Backoff in deiner retry logic.Error Handling
Um errors effektiv zu verwalten, konsultiere die Abschnitte Error Codes und Transaction Failures für detaillierte Anleitungen.Error Codes
Verschaffe dir einen umfassenden Überblick über errors und deren Lösungen.
Transaction Failures
Erhalte Einblicke in häufige Transaktionsprobleme und deren Lösungen.
Webhooks
Erhalte Echtzeitbenachrichtigungen zu payment events. In unserem Webhook Guide findest du Anweisungen zur Einrichtung.Webhook Guide
Richte Webhooks für Echtzeitbenachrichtigungen und die Verarbeitung von events ein.
Verwandte Developer Guides
In unseren umfassenden Guides erfährst du, wie du wichtige Funktionen mit der API implementierst:One-time Payments Integration
Erfahre, wie du einmalige Zahlungen, Checkout-Sitzungen und payment links in deine Anwendung integrierst
Subscription Integration
Vollständiger Leitfaden zur Implementierung von subscriptions, zur Verwaltung von Plänen und zur Verarbeitung von Ereignissen im Lebenszyklus von subscriptions
Usage-Based Billing
Richte meter und usage events für nutzungsbasierte Abrechnung und verbrauchsbasierte Preismodelle ein
Webhooks
Erhalte Echtzeitbenachrichtigungen und automatisiere Workflows mit Webhook events
Checkout Sessions
Erstelle sichere, gehostete Checkout-Erlebnisse mit vollständiger Anpassbarkeit und erweiterten Funktionen