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:- Checkout Sessions (raccomandato): Migliore per la maggior parte delle integrazioni. Crea una sessione sul tuo server e reindirizza i clienti a un checkout sicuro e ospitato.
- Overlay Checkout: Utilizza quando hai bisogno di un’esperienza in-page che apre il checkout come un overlay modale sul tuo sito.
- Inline Checkout: Integra direttamente il checkout nel layout della tua pagina per esperienze di checkout completamente integrate e brandizzate.
- Static Payment Links: URL condivisibili istantaneamente senza codice per una rapida raccolta dei pagamenti.
- Dynamic Payment Links: Link creati programmaticamente. Tuttavia, le Checkout Sessions 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. Inline Checkout
Per esperienze di checkout completamente integrate incorporate direttamente nella tua pagina, utilizza la nostra integrazione Inline Checkout. Questo ti consente di costruire riepiloghi degli ordini personalizzati e avere il controllo completo sul layout del checkout mentre Dodo Payments gestisce in modo sicuro la raccolta dei pagamenti.4. Static Payment Links
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 fornito firstName o lastName).
-
Nome di battesimo del cliente.
-
Cognome del cliente.
-
Indirizzo email del cliente.
-
Paese del cliente.
-
Indirizzo.
-
Città.
-
Stato o provincia.
-
Codice postale/CAP.
-
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… flag 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. Di default è 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 tutto il processo di checkout.L’esperienza di checkout del cliente è ora semplificata e personalizzata in base ai tuoi parametri.
4. Dynamic Payment Links
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 API reference
- API per Link di Pagamento in Abbonamento API reference
Assicurati di passare
payment_link = true per ottenere il link di pagamento - Node.js SDK
- Python SDK
- Go SDK
- Api Reference
Dopo aver creato il link di pagamento, reindirizza i tuoi clienti per completare il pagamento.