SDKs & Libraries
Accelerera din integration genom att använda officiella SDK:er för TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby och React Native. Dessa bibliotek förenklar API-förfrågningar, autentisering och felhantering, så att du kan fokusera på att bygga fantastiska betalningsupplevelser.
Miljö-URL:er
- Testläge:
https://test.dodopayments.com - Live-läge:
https://live.dodopayments.com
Läs mer om Testläge vs Live-läge.
API-nyckelhantering och autentisering
Generate a New Key
Välj Add API Key, ange ett beskrivande namn och konfigurera skrivåtkomst:
- Aktivera skrivåtkomst (markerad): Full läs- och skrivbehörighet för alla API-operationer
- Aktivera skrivåtkomst (avmarkerad): Endast läsbehörighet - kan endast hämta data (betalningar, prenumerationer, kunder, produkter). Kan inte skapa eller ändra resurser.
Svarformat
Hastighetsbegränsningar
Vårt API använder ett tvåfönster-system för hastighetsbegränsning med skydd mot plötsliga toppar. Gränser tillämpas baserat på din autentiseringsmetod och affärsnivå.Standardgränser (nivå 0)
| Fönster | Gräns |
|---|---|
| Per sekund (burst) | 40 förfrågningar |
| Per minut (sustained) | 240 förfrågningar |
Företagsnivåer
Högre hastighetsgränser är tillgängliga för företag med ökade API-behov:| Nivå | Burst (per sekund) | Sustained (per minut) |
|---|---|---|
| Nivå 0 (standard) | 40 | 240 |
| Nivå 1 | 100 | 1 000 |
| Nivå 2 | 500 | 5 000 |
Förfrågningar utan autentisering
Förfrågningar utan giltiga autentiseringshuvuden begränsas efter IP-adress:| Fönster | Gräns |
|---|---|
| Per sekund (burst) | 20 förfrågningar |
| Per minut (sustained) | 100 förfrågningar |
Svarshuvuden för hastighetsbegränsning
Övervaka din användning med dessa svarshuvuden:X-RateLimit-Limit- Maximalt antal tillåtna förfrågningarX-RateLimit-Remaining- Förfrågningar kvar i det aktuella fönstretX-RateLimit-Reset- Tidpunkt när hastighetsgränsen återställs
När du överskrider hastighetsgränserna returnerar API:et ett
429 Too Many Requests-svar. Implementera exponentiell backoff i din logik för omförsök.Felhantering
För att hantera fel effektivt, konsultera avsnitten Error Codes och Transaction Failures för detaljerad vägledning.Error Codes
Fördjupa dig i detaljerade felbeskrivningar och deras lösningar.
Transaction Failures
Få insikter om vanliga transaktionsproblem och deras lösningar.
Webhooks
Ta emot aviseringar i realtid om betalevenemang. Se vår Webhook Guide för installationsinstruktioner.Webhook Guide
Ställ in webhooks för aviseringar i realtid och hantering av händelser.