API-referens - Dodo Payments Documentation

SDKs & Libraries

Officiella backend-SDK:er för TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby och Rust. Dessa bibliotek hanterar autentisering, serialisering och felhantering så att du kan fokusera på din integration.

Mobile Checkout SDKs

Öppna Dodos hostade checkout från Android-, iOS-, React Native- och Flutter-appar och få tillbaka ett typat resultat i ett enda anrop. Dessa SDK:er innehåller ingen API-nyckel.

Miljö-URL:er

Testläge: https://test.dodopayments.com
Live-läge: https://live.dodopayments.com

Läs mer om Testläge jämfört med live-läge.

Autentisering

Alla API-begäranden kräver en API-nyckel. Generera en i din dashboard och inkludera den i Authorization-headern i varje begäran.

Generate an API Key

Gå till Developer → API Keys i din dashboard och välj Add API Key. Skapa nyckeln i det läge du vill anropa: en testnyckel fungerar endast med https://test.dodopayments.com och en live-nyckel fungerar endast med https://live.dodopayments.com. Ge nyckeln ett beskrivande namn och välj din åtkomstnivå:

Enable write access markerat (standard): Fullständiga läs- och skrivbehörigheter för alla API-operationer.
Enable write access avmarkerat: Skrivskyddad åtkomst. Du kan hämta data (betalningar, prenumerationer, kunder och produkter), men du kan inte skapa eller ändra resurser.

Avmarkera Enable write access för integrationer som bara behöver visa data, till exempel analysverktyg eller dashboard-integrationer.

Store Your Key Securely

Kopiera nyckeln omedelbart. Du kommer inte att kunna se den igen. Lagra den i en miljövariabel som DODO_PAYMENTS_API_KEY.

Authenticate Requests

Inkludera din API-nyckel i Authorization-headern i varje begäran:

Authorization: Bearer YOUR_API_KEY

Exponera aldrig din API-nyckel i kod på klientsidan, offentliga kodförråd eller versionshantering.

Svarsformat

Lyckade begäranden returnerar 200 eller 201 med en JSON-body, eller 204 utan body. Fel returnerar statuskoden 4xx eller 5xx med en JSON-body som innehåller en code och en message.

{
  "payment_id": "pay_gr4RizvMOXFJ6xca3y2tU",
  "status": "succeeded",
  "total_amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "code": "INVALID_REQUEST_BODY",
  "message": "Your request body is invalid. Please check your request headers and object."
}

Hastighetsbegränsningar

API:et tillämpar två begränsningar samtidigt: en burst-begränsning per sekund och en uthållig begränsning per minut. Begränsningarna gäller för hela ditt företag, för alla dess API-nycklar, och beror på företagets nivå för hastighetsbegränsning.

Standardnivå

Fönster	Begränsning
Per sekund (burst)	40 begäranden
Per minut (uthållig)	240 begäranden

Högre nivåer

Företag med större API-behov kan uppgradera till högre hastighetsbegränsningar:

Nivå	Burst (per sekund)	Uthållig (per minut)
Standard	40	240
Nivå 1	100	1 000
Nivå 2	500	5 000

För att uppgradera din nivå för hastighetsbegränsning, skicka ett e-postmeddelande till support@dodopayments.com.

Begäranden utan autentisering

Begäranden utan en giltig API-nyckel begränsas baserat på IP-adress:

Fönster	Begränsning
Per sekund (burst)	20 begäranden
Per minut (uthållig)	100 begäranden

Headers för hastighetsbegränsning

Svar innehåller headers som visar din aktuella användning:

X-RateLimit-Limit — Maximalt antal begäranden som tillåts i det aktuella fönstret.
X-RateLimit-Remaining — Antal begäranden som återstår innan du når begränsningen.
X-RateLimit-Reset — Antal sekunder tills det aktuella fönstret återställs.

När du överskrider begränsningen returnerar API:et 429 Too Many Requests. Implementera exponentiell backoff i din retry-logik.

Felhantering

Om du vill ta reda på vad ett fel betyder och hur du löser det kan du läsa sidorna om felkoder och transaktionsfel.

Error Codes

Fullständig lista över felkoder och deras betydelser.

Transaction Failures

Vanliga transaktionsproblem och hur du hanterar dem.

Webhooks

Ta emot realtidsnotiser när betalningar, prenumerationer och andra händelser inträffar. Konfigurera webhooks i din dashboard och hantera de händelser som din integration behöver.

Webhook Guide

Konfigurera webhooks, hantera händelser och verifiera signaturer.

Integrationsguider

Börja med en av dessa guider för att bygga din första integration:

One-time Payments

Skapa checkout-sessioner och betalningslänkar samt hantera betalningar.

Subscriptions

Konfigurera återkommande fakturering, hantera planer och hantera livscykelhändelser.

Usage-Based Billing

Mät användning och debitera kunder baserat på förbrukning.

Checkout Sessions

Skapa säkra, hostade checkout-upplevelser.

SDKs & Libraries

Mobile Checkout SDKs

​Miljö-URL:er

​Autentisering

​Svarsformat

​Hastighetsbegränsningar

​Standardnivå

​Högre nivåer

​Begäranden utan autentisering

​Headers för hastighetsbegränsning

​Felhantering

Error Codes

Transaction Failures

​Webhooks

Webhook Guide

​Integrationsguider

One-time Payments

Subscriptions

Usage-Based Billing

Checkout Sessions

Miljö-URL:er

Autentisering

Svarsformat

Hastighetsbegränsningar

Standardnivå

Högre nivåer

Begäranden utan autentisering

Headers för hastighetsbegränsning

Felhantering

Webhooks

Integrationsguider