Cosa ti serve
| Campo | Cosa fa |
|---|---|
| API key | Ci permette di chiamare Dodo per creare il checkout ospitato. Segreta. |
| Webhook signing secret (whsec_…) | Conferma che un webhook provenga davvero da Dodo. Segreta. |
| Return URL | Dove arriva il cliente dopo il checkout. |
Perché chiediamo ogni campo
API key
Autorizza la creazione del checkout ospitato, così l'addebito passa per il tuo account.
Webhook signing secret
Dimostra che un webhook in arrivo provenga davvero da Dodo, così nessuno può falsificare un evento "pagato". È un valore separato dall'API key.
Return URL
Impostazione semplice: dove arriva il cliente dopo il checkout. Non segreta.
Configurazione
- Usa la modalità test (gratuita)
Dodo ha un ambiente di test separato. Le chiavi in modalità test girano sull'host di test di Dodo, e non si muove denaro reale.
- Accedi su app.dodopayments.com.
- Dodo separa le chiavi Live e Test. Configura prima in test, poi ripeti in live.
- Copia la tua API key
Vai su Developer → API Keys e copia la chiave Test per verificare, o la chiave Live per incassare pagamenti reali.
Dodo → Developer → API Keys - Aggiungi il webhook
- Aggiungi un webhook in Dodo.
- Imposta l'URL del webhook sull'indirizzo del webhook del tuo progetto (sotto).
- Copia il webhook signing secret (whsec_…). Aggiungi un webhook separato in test e in live.
https://api.coinmoebius.com/webhook/dodopayments/<your project id>Dodo → Developer → Webhooks - Collega nella dashboard
Aggiungi provider → Dodo Payments. Inserisci il Return URL e il gruppo Live (Live API key, Live webhook signing secret). Aggiungi il gruppo Test opzionale per verificare prima. Il gruppo Test è accoppiato: aggiungi sia una test API key sia un test webhook secret, oppure lascia entrambi vuoti. Live e test sono verificati separatamente.
Dopo aver collegato
Esegui un pagamento di prova prima di andare in produzione:
- Crea un prodotto e imposta il suo Ambiente su Testing. Questo esegue il prodotto sulle tue credenziali di test, così puoi piazzare un ordine completo senza muovere denaro. (Se hai saltato il set di test, un prodotto in Testing ricade su live, quindi aggiungilo prima.)
- Metti il pulsante di acquisto su una pagina (un file HTML locale va bene) puntato sul tuo progetto.
- Completa il checkout nella modalità test di Dodo.
- Apri la scheda Transazioni. Appare una nuova riga, etichettata Testing. Quando il suo stato raggiunge succeeded, le tue credenziali e il webhook funzionano entrambi da capo a fondo.
Cambia l'Ambiente del prodotto su Live quando sei pronto per i pagamenti reali.
Risoluzione dei problemi
Inizia da Verifica. Nella dashboard, fai clic su Verifica (o Verifica credenziali di test) per controllare la tua API key.
Verifica credenziali di test dice che non ci sono credenziali di test salvate.
Aggiungi una test API key nella scheda Test, salva il provider, poi riapri il dialogo e verifica.
Il pagamento si completa ma l'ordine resta in sospeso.
Conferma che l'URL del webhook corrisponda e che il signing secret corrisponda al webhook nello stesso ambiente (test secret per test, live per live).
Il salvataggio del gruppo Test viene rifiutato.
Il gruppo Test è accoppiato: aggiungi sia una test API key sia un test webhook secret, oppure lascia entrambi vuoti.
Conferma da capo a fondo.
Dashboard Dodo → Developer → Webhooks → Send Example (o la CLI di Dodo) puntato sul tuo URL di webhook, poi guarda l'ordine aggiornarsi.
Buono a sapersi
Solo pagamenti una tantum. Coin Moebius usa Dodo per pagamenti singoli, non per abbonamenti.
Ruotare i secret. Ruota l'API key o il webhook secret quando vuoi, poi incolla il nuovo valore. I campi segreti restano vuoti in modifica.
Domande? Join our Discord