Requisiti
Per integrare l’API Dodo Payments, avrai bisogno di:- Un account commerciante Dodo Payments
- Credenziali API (chiave API e chiave segreta webhook) dal dashboard
Configurazione del Dashboard
- Naviga al Dashboard Dodo Payments
- Crea un prodotto (pagamento una tantum o abbonamento)
-
Genera la tua chiave API:
- Vai su Sviluppatore > API
- Guida dettagliata
- Copia la chiave API nell’ambiente denominato DODO_PAYMENTS_API_KEY
-
Configura i webhook:
- Vai su Sviluppatore > Webhook
- Crea un URL webhook per le notifiche di pagamento
- Copia la chiave segreta webhook nell’ambiente
Integrazione
Link di pagamento
Scegli il percorso di integrazione che si adatta al tuo caso d’uso:- Sessioni di checkout (raccomandato): Migliore per la maggior parte delle integrazioni. Crea una sessione sul tuo server e reindirizza i clienti a un checkout sicuro e ospitato.
- Checkout Overlay (incorporato): Utilizza quando hai bisogno di un’esperienza in pagina che incorpora il checkout ospitato sul tuo sito.
- Link di pagamento statici: URL condivisibili istantaneamente senza codice per una rapida raccolta di pagamenti.
- Link di pagamento dinamici: Link creati programmaticamente. Tuttavia, le sessioni di checkout sono raccomandate e offrono maggiore flessibilità.
1. Sessioni di checkout
Utilizza le sessioni di checkout per creare un’esperienza di checkout sicura e ospitata per pagamenti una tantum o abbonamenti. Crei una sessione sul tuo server, quindi reindirizzi il cliente alcheckout_url.
Le sessioni di checkout sono valide per 24 ore per impostazione predefinita. Se passi
confirm=true, le sessioni sono valide per 15 minuti e tutti i campi richiesti devono essere forniti.1
Crea una sessione di checkout
Scegli il tuo SDK preferito o chiama l’API REST.
- Node.js SDK
- Python SDK
- REST API
2
Reindirizza il cliente al checkout
Dopo la creazione della sessione, reindirizza a
checkout_url per avviare il flusso ospitato.2. Checkout Overlay
Per un’esperienza di checkout in pagina senza soluzione di continuità, esplora la nostra integrazione Checkout Overlay che consente ai clienti di completare i pagamenti senza lasciare il tuo sito web.3. Link di pagamento statici
I link di pagamento statici ti consentono di accettare rapidamente pagamenti condividendo un semplice URL. Puoi personalizzare l’esperienza di checkout passando parametri di query per precompilare i dettagli del cliente, controllare i campi del modulo e aggiungere metadati personalizzati.1
Costruisci il tuo link di pagamento
Inizia con l’URL di base e aggiungi il tuo ID prodotto:
2
Aggiungi parametri core
Includi parametri di query essenziali:
-
Numero di articoli da acquistare.
-
URL a cui reindirizzare dopo il completamento del pagamento.
L’URL di reindirizzamento includerà i dettagli del pagamento come parametri di query, ad esempio:
https://example.com/?payment_id=pay_ts2ySpzg07phGeBZqePbH&status=succeeded3
Precompila le informazioni del cliente (opzionale)
Aggiungi campi cliente o di fatturazione come parametri di query per semplificare il checkout.
Campi cliente supportati
Campi cliente supportati
-
Nome completo del cliente (ignorato se sono forniti firstName o lastName).
-
Nome del cliente.
-
Cognome del cliente.
-
Indirizzo email del cliente.
-
Paese del cliente.
-
Indirizzo.
-
Città.
-
Stato o provincia.
-
Codice postale.
-
true o false
4
Controlla i campi del modulo (opzionale)
Puoi disabilitare campi specifici per renderli di sola lettura per il cliente. Questo è utile quando hai già i dettagli del cliente (ad esempio, utenti con accesso).
disable… su true:- Tabella dei flag di disabilitazione
| Campo | Flag di disabilitazione | Parametro richiesto |
|---|---|---|
| Nome completo | disableFullName | fullName |
| Nome | disableFirstName | firstName |
| Cognome | disableLastName | lastName |
disableEmail | email | |
| Paese | disableCountry | country |
| Indirizzo | disableAddressLine | addressLine |
| Città | disableCity | city |
| Stato | disableState | state |
| Codice postale | disableZipCode | zipCode |
Impostare
showDiscounts=false disabiliterà e nasconderà la sezione sconti nel modulo di checkout. Utilizza questo se vuoi impedire ai clienti di inserire codici coupon o promozionali durante il checkout.5
Aggiungi controlli avanzati (opzionale)
-
Specifica la valuta di pagamento. Per impostazione predefinita, è la valuta del paese di fatturazione.
-
Mostra o nascondi il selettore di valuta.
-
Importo in centesimi (solo per prezzi Pay What You Want).
-
Campi di metadati personalizzati (ad esempio,
metadata_orderId=123).
6
Condividi il link
Invia il link di pagamento completato al tuo cliente. Quando lo visitano, tutti i parametri di query vengono raccolti e memorizzati con un ID di sessione. L’URL viene quindi semplificato per includere solo il parametro di sessione (ad esempio,
?session=sess_1a2b3c4d). Le informazioni memorizzate persistono attraverso i refresh della pagina e sono accessibili durante l’intero processo di checkout.L’esperienza di checkout del cliente è ora semplificata e personalizzata in base ai tuoi parametri.
4. Link di pagamento dinamici
Creati tramite chiamata API o il nostro SDK con i dettagli del cliente. Ecco un esempio: Ci sono due API per creare link di pagamento dinamici:- API per link di pagamento una tantum Riferimento API
- API per link di pagamento in abbonamento Riferimento API
Assicurati di passare
payment_link = true per ottenere il link di pagamento - Node.js SDK
- Python SDK
- Go SDK
- Riferimento API
Dopo aver creato il link di pagamento, reindirizza i tuoi clienti per completare il pagamento.