SDKs & Libraries
SDK backend ufficiali per TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby e Rust. Queste librerie gestiscono l’autenticazione, la serializzazione e la gestione degli errori, così puoi concentrarti sulla tua integrazione.
Mobile Checkout SDKs
Apri il checkout ospitato di Dodo dalle app Android, iOS, React Native e Flutter e ricevi un risultato tipizzato con una sola chiamata. Questi SDK non contengono alcuna API key.
URL degli ambienti
- Modalità di test:
https://test.dodopayments.com - Modalità live:
https://live.dodopayments.com
Scopri di più su Test Mode vs Live Mode.
Autenticazione
Le richieste API richiedono una chiave API, ad eccezione di alcuni endpoint pubblici come Attiva licenza, Convalida licenza e Disattiva licenza. Generane una nella tua dashboard e includila nell’headerAuthorization di ogni richiesta.
1
Generate an API Key
Vai su Developer → API Keys nella tua dashboard e seleziona Add API Key. Crea la key nella modalità che vuoi utilizzare: una key in modalità di test funziona solo con
https://test.dodopayments.com, mentre una key in modalità live funziona solo con https://live.dodopayments.com. Assegna alla key un nome descrittivo e scegli il livello di accesso:- Enable write access selezionato (impostazione predefinita): autorizzazioni complete di lettura e scrittura per tutte le operazioni API.
- Enable write access non selezionato: accesso in sola lettura. Puoi recuperare dati (pagamenti, abbonamenti, clienti, prodotti), ma non puoi creare o modificare risorse.
2
Store Your Key Securely
Copia subito la key. Non potrai visualizzarla di nuovo. Conservala in una variabile d’ambiente come
DODO_PAYMENTS_API_KEY.3
Authenticate Requests
Includi la tua API key nell’header
Authorization di ogni richiesta:Formato della risposta
Le richieste completate correttamente restituiscono200 o 201 con un corpo JSON, oppure 204 senza corpo. Gli errori restituiscono uno status 4xx o 5xx con un corpo JSON contenente un code e un message.
Limiti di frequenza
L’API applica contemporaneamente due limiti: un limite di picco al secondo e un limite sostenuto al minuto. I limiti si applicano all’intera attività, a tutte le sue API keys, e dipendono dal relativo livello di limite di frequenza.Livello predefinito
Livelli superiori
Le attività con esigenze API maggiori possono passare a limiti di frequenza superiori:Richieste non autenticate
Le richieste senza una API key valida sono soggette a limitazione in base all’indirizzo IP:Header dei limiti di frequenza
Le risposte includono header che mostrano l’utilizzo attuale:X-RateLimit-Limit— Numero massimo di richieste consentite nella finestra corrente.X-RateLimit-Remaining— Richieste rimanenti prima di raggiungere il limite.X-RateLimit-Reset— Secondi mancanti al ripristino della finestra corrente.
429 Too Many Requests. Implementa un exponential backoff nella logica di retry.
Gestione degli errori
Per scoprire il significato di un errore e come risolverlo, consulta le pagine relative ai codici di errore e ai fallimenti delle transazioni.Error Codes
Elenco completo dei codici di errore e dei relativi significati.
Transaction Failures
Problemi comuni nelle transazioni e come gestirli.
Webhook
Ricevi notifiche in tempo reale quando si verificano pagamenti, abbonamenti e altri eventi. Configura i webhook nella tua dashboard e gestisci gli eventi necessari alla tua integrazione.Webhook Guide
Configura i webhook, gestisci gli eventi e verifica le firme.
Guide all’integrazione
Inizia con una di queste guide per creare la tua prima integrazione:One-time Payments
Crea sessioni di checkout e payment links e gestisci i pagamenti.
Subscriptions
Configura la fatturazione ricorrente, gestisci i piani e gestisci gli eventi del ciclo di vita.
Usage-Based Billing
Misura l’utilizzo e addebita i clienti in base al consumo.
Checkout Sessions
Crea esperienze di checkout sicure e ospitate.