Introduzione - Dodo Payments Documentation

SDKs & Libraries

SDK backend ufficiali per TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby e Rust. Queste librerie semplificano le richieste API, l’autenticazione e la gestione degli errori, permettendoti di concentrarti sulla creazione di esperienze di pagamento eccellenti.

Mobile Checkout SDKs

Stai creando un’app nativa? Apri il checkout ospitato di Dodo e ricevi un risultato tipizzato con una sola chiamata, su Android, iOS, React Native e Flutter. Questi non contengono alcuna API key.

URL degli ambienti

Test Mode: https://test.dodopayments.com
Live Mode: https://live.dodopayments.com

Scopri di più su Test Mode vs Live Mode.

Gestione delle API Key e autenticazione

Access API Keys

Vai a Developer → API Keys nella dashboard per gestire le tue chiavi.

Generate a New Key

Seleziona Add API Key, inserisci un nome descrittivo e configura l’accesso in scrittura:

Enable write access (selezionato): autorizzazioni complete di lettura e scrittura per tutte le operazioni API
Enable write access (non selezionato): accesso in sola lettura: puoi solo recuperare dati (pagamenti, abbonamenti, clienti, prodotti). Non puoi creare o modificare risorse.

Deseleziona “Enable write access” per le integrazioni della dashboard, gli strumenti di analisi e qualsiasi sistema che debba solo visualizzare i dati senza apportare modifiche.

Store Your Key Securely

Copia immediatamente la chiave generata e assicurati di conservarla in modo sicuro.

Authenticate Your API Requests

Usa le tue API keys per autenticare tutte le richieste. Applica il seguente formato di autorizzazione:

Authorization: Bearer YOUR_API_KEY

Non esporre mai le tue API keys segrete nel codice lato client o nei repository pubblici.

Formato della risposta

{
  "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"
}

Limiti di frequenza

La nostra API utilizza un sistema di rate limiting a doppia finestra con protezione dai picchi. I limiti vengono applicati in base al tuo metodo di autenticazione e al livello della tua attività.

Limiti predefiniti (Tier 0)

Finestra	Limite
Al secondo (Burst)	40 richieste
Al minuto (Sustained)	240 richieste

Livelli di attività

Sono disponibili limiti di frequenza più elevati per le attività con maggiori esigenze API:

Livello	Burst (al secondo)	Sustained (al minuto)
Tier 0 (predefinito)	40	240
Tier 1	100	1.000
Tier 2	500	5.000

Contatta il supporto per portare la tua attività a un livello di rate limiting superiore.

Richieste non autenticate

Le richieste senza header di autenticazione validi sono soggette a rate limiting in base all’indirizzo IP:

Finestra	Limite
Al secondo (Burst)	20 richieste
Al minuto (Sustained)	100 richieste

Header dei limiti di frequenza

Monitora il tuo utilizzo con questi header di risposta:

X-RateLimit-Limit - Numero massimo di richieste consentite
X-RateLimit-Remaining - Richieste rimanenti nella finestra corrente
X-RateLimit-Reset - Momento in cui il limite di frequenza viene reimpostato

Quando superi i limiti di frequenza, l’API restituisce una risposta 429 Too Many Requests. Implementa un exponential backoff nella logica dei retry.

Gestione degli errori

Per gestire efficacemente gli errori, consulta le sezioni Error Codes e Transaction Failures per indicazioni dettagliate.

Error Codes

Approfondisci i dettagli completi sugli errori e le relative soluzioni.

Transaction Failures

Scopri le problematiche comuni delle transazioni e le relative soluzioni.

Webhook

Ricevi notifiche in tempo reale sugli eventi di pagamento. Consulta la nostra Webhook Guide per le istruzioni di configurazione.

Webhook Guide

Configura i webhook per ricevere notifiche in tempo reale e gestire gli eventi.

Guide per sviluppatori correlate

Consulta le nostre guide complete per scoprire come implementare le funzionalità principali utilizzando l’API:

One-time Payments Integration

Scopri come integrare pagamenti una tantum, sessioni di checkout e payment link nella tua applicazione

Subscription Integration

Guida completa all’implementazione degli abbonamenti, alla gestione dei piani e alla gestione degli eventi del ciclo di vita degli abbonamenti

Usage-Based Billing

Configura i meter e gli eventi di utilizzo per la fatturazione basata sul consumo e i modelli di prezzo basati sull’utilizzo

Webhooks

Ricevi notifiche in tempo reale e automatizza i workflow con gli eventi webhook

Checkout Sessions

Crea esperienze di checkout ospitato sicure, con personalizzazione completa e funzionalità avanzate

SDKs & Libraries

Mobile Checkout SDKs

​URL degli ambienti

​Gestione delle API Key e autenticazione

​Formato della risposta

​Limiti di frequenza

​Limiti predefiniti (Tier 0)

​Livelli di attività

​Richieste non autenticate

​Header dei limiti di frequenza

​Gestione degli errori

Error Codes

Transaction Failures

​Webhook

Webhook Guide

​Guide per sviluppatori correlate

One-time Payments Integration

Subscription Integration

Usage-Based Billing

Webhooks

Checkout Sessions

URL degli ambienti

Gestione delle API Key e autenticazione

Formato della risposta

Limiti di frequenza

Limiti predefiniti (Tier 0)

Livelli di attività

Richieste non autenticate

Header dei limiti di frequenza

Gestione degli errori

Webhook

Guide per sviluppatori correlate