Introduktion - Dodo Payments Documentation

SDKs & Libraries

Officiella backend-SDK:er för TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby och Rust. Dessa bibliotek förenklar API-anrop, autentisering och felhantering, så att du kan fokusera på att skapa fantastiska betalningsupplevelser.

Mobile Checkout SDKs

Bygger du en native-app? Öppna Dodos hostade checkout och få tillbaka ett typat resultat i ett enda anrop på Android, iOS, React Native och Flutter. Dessa 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.

Hantering av API-nycklar och autentisering

Access API Keys

Gå till Developer → API Keys i din dashboard för att hantera dina nycklar.

Generate a New Key

Välj Add API Key, ange ett beskrivande namn och konfigurera skrivåtkomst:

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

Avmarkera “Enable write access” för dashboard-integrationer, analysverktyg och alla system som endast behöver visa data utan att göra ändringar.

Store Your Key Securely

Kopiera den genererade nyckeln omedelbart och se till att den lagras säkert.

Authenticate Your API Requests

Använd dina API-nycklar för att autentisera alla anrop. Använd följande auktoriseringsformat:

Authorization: Bearer YOUR_API_KEY

Exponera aldrig dina hemliga API-nycklar i kod på klientsidan eller i offentliga repositories.

Svarsformat

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

{
  "code": "INVALID_REQUEST",
  "message": "The request contains invalid parameters"
}

Anropsbegränsningar

Vårt API använder ett system för anropsbegränsning med två tidsfönster och skydd mot toppar. Begränsningarna tillämpas baserat på din autentiseringsmetod och företagsnivå.

Standardbegränsningar (nivå 0)

Fönster	Begränsning
Per sekund (topp)	40 anrop
Per minut (varaktig)	240 anrop

Företagsnivåer

Högre anropsbegränsningar är tillgängliga för företag med större API-behov:

Nivå	Topp (per sekund)	Varaktig (per minut)
Nivå 0 (standard)	40	240
Nivå 1	100	1 000
Nivå 2	500	5 000

Kontakta supporten för att uppgradera ditt företag till en högre nivå för anropsbegränsning.

Oautentiserade anrop

Anrop utan giltiga autentiseringsheaders begränsas baserat på IP-adress:

Fönster	Begränsning
Per sekund (topp)	20 anrop
Per minut (varaktig)	100 anrop

Headers för anropsbegränsning

Övervaka din användning med dessa svarheaders:

X-RateLimit-Limit – Maximalt tillåtna anrop
X-RateLimit-Remaining – Återstående anrop i det aktuella fönstret
X-RateLimit-Reset – Tidpunkt då anropsbegränsningen återställs

När du överskrider anropsbegränsningarna returnerar API:et ett svar med 429 Too Many Requests. Implementera exponentiell backoff i din retry-logik.

Felhantering

För att effektivt hantera fel kan du läsa avsnitten Felkoder och Transaktionsfel för detaljerad vägledning.

Error Codes

Fördjupa dig i omfattande feldetaljer och deras lösningar.

Transaction Failures

Få insikt i vanliga transaktionsproblem och deras lösningar.

Webhooks

Ta emot realtidsaviseringar om betalningshändelser. Se vår Webhook-guide för instruktioner om konfiguration.

Webhook Guide

Konfigurera webhooks för realtidsaviseringar och händelsehantering.

Relaterade utvecklarguider

Utforska våra omfattande guider för att förstå hur du implementerar viktiga funktioner med hjälp av API:et:

One-time Payments Integration

Lär dig hur du integrerar engångsbetalningar, checkout-sessioner och betalningslänkar i din applikation

Subscription Integration

Komplett guide för att implementera prenumerationer, hantera planer och hantera händelser under prenumerationers livscykel

Usage-Based Billing

Konfigurera mätare och användningshändelser för volymbaserad fakturering och prismodeller baserade på förbrukning

Webhooks

Ta emot realtidsaviseringar och automatisera arbetsflöden med webhook-händelser

Checkout Sessions

Skapa säkra, hostade checkout-upplevelser med fullständig anpassning och avancerade funktioner

SDKs & Libraries

Mobile Checkout SDKs

​Miljö-URL:er

​Hantering av API-nycklar och autentisering

​Svarsformat

​Anropsbegränsningar

​Standardbegränsningar (nivå 0)

​Företagsnivåer

​Oautentiserade anrop

​Headers för anropsbegränsning

​Felhantering

Error Codes

Transaction Failures

​Webhooks

Webhook Guide

​Relaterade utvecklarguider

One-time Payments Integration

Subscription Integration

Usage-Based Billing

Webhooks

Checkout Sessions

Miljö-URL:er

Hantering av API-nycklar och autentisering

Svarsformat

Anropsbegränsningar

Standardbegränsningar (nivå 0)

Företagsnivåer

Oautentiserade anrop

Headers för anropsbegränsning

Felhantering

Webhooks

Relaterade utvecklarguider