Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Nuove Funzioni
1. Codici Sconto Combinati
Le sessioni di checkout, i pagamenti, gli abbonamenti e le modifiche ai piani ora accettano fino a 20 codici sconto in una singola richiesta tramite l’array discount_codes. I codici sono applicati in ordine di array — il primo codice idoneo riduce il prezzo base, il secondo riduce il prezzo già scontato, e così via — quindi puoi stratificare le campagne senza creare codici combinati su misura.
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
customer: { email: 'user@example.com' },
return_url: 'https://yoursite.com/return'
});
| Superficie | Campo | Max codici |
|---|
| Sessioni di Checkout | discount_codes | 20 |
| Pagamenti | discount_codes | 20 |
| Abbonamenti | discount_codes | 20 |
| Modifiche Piano | discount_codes | 20 |
Valore discount_codes | Effetto |
|---|
| Non fornito | Gli sconti esistenti con preserve_on_plan_change=true sono mantenuti se applicabili al nuovo prodotto |
[] (array vuoto) | Tutti gli sconti esistenti sono rimossi dall’abbonamento |
['CODE_A', 'CODE_B', ...] | Sostituisce qualsiasi sconto esistente con questo set combinato, applicato in ordine di array |
discounts su pagamenti e abbonamenti — ogni voce include discount_id, position, e cycles_remaining (per abbonamenti). Il campo singolare ereditato discount_id è deprecato ma ancora presente per compatibilità con le versioni precedenti.
Il campo singolare discount_code è deprecato ma ancora pienamente supportato — le integrazioni esistenti continuano a funzionare senza modifiche. Non può essere combinato con discount_codes nella stessa richiesta. Consigliamo di migrare a discount_codes quando conveniente, anche per singoli codici, per sfruttare la combinazione e la forma della risposta più ricca.
2. Sette Nuove Email di Notifica Cliente
Sette nuove email transazionali sono ora inviate automaticamente ai tuoi clienti, coprendo conferme di rimborso, traguardi del ciclo di vita degli abbonamenti, e fallimenti di pagamento. Ogni email è attivabile indipendentemente da Impostazioni → Comunicazioni nella sezione Email Cliente.
Iscrizione (attivato di default)
| Email | Quando si attiva |
|---|
| Rimborso Riuscito | Un rimborso è stato elaborato con successo e i fondi sono in restituzione al cliente |
| Fine Prova Abbonamento | ~2 giorni prima della scadenza di una prova e dell’addebito del primo pagamento |
| Abbonamento Annullato Immediatamente | Un abbonamento è annullato con effetto immediato |
| Abbonamento Annullato Alla Prossima Data di Fatturazione | Un abbonamento è programmato per l’annullamento alla fine del periodo di fatturazione corrente |
| Email | Quando si attiva |
|---|
| Pagamento Fallito | Tentativo di pagamento fallito — attiva se vuoi che Dodo Payments notifichi direttamente il cliente invece di gestirlo nel tuo sistema |
| Rinnovo Abbonamento Fallito | Un pagamento per rinnovo abbonamento fallisce specificamente; si attiva invece di (non in aggiunta a) l’email generale di Pagamento Fallito per pagamenti di rinnovo |
| Promemoria Rinnovo Imminente | ~2 giorni prima di un rinnovo dell’abbonamento |
Se gestisci la comunicazione con i clienti personalmente tramite webhook, lascia disattivate le email di cancellazione per evitare di inviare ai clienti notifiche duplicate per lo stesso evento.
Le email ai clienti sono separate dalle email di notifica inviate al tuo team. Disattivare un’email cliente non influisce sulle notifiche del team per lo stesso evento.
3. Sunbit — Finanziamento a Rate per Clienti USA
Sunbit è ora disponibile come metodo di pagamento Compra Ora e Paga Dopo, permettendo ai clienti USA di suddividere gli acquisti in rate mensili gestibili al checkout.
| Caratteristica | Dettagli |
|---|
| Disponibilità | Stati Uniti |
| Valuta | USD |
| Importo minimo | $60.00 |
| Importo massimo | $19,999.00 |
| Abbonamenti | Non supportato (solo pagamenti una tantum) |
sunbit in allowed_payment_method_types per abilitarlo su una sessione di checkout:
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_123', quantity: 1 }],
allowed_payment_method_types: ['sunbit', 'credit', 'debit'],
return_url: 'https://example.com/success'
});
Includi sempre credit e debit come opzioni di riserva. Non tutti i clienti si qualificheranno per il finanziamento Sunbit, e le transazioni al di fuori dell’intervallo 60.00–19,999.00 non mostreranno l’opzione. Miglioramenti
4. Revisione della Pagina di Pagamento Checkout
La pagina di pagamento del checkout è stata sostanzialmente rielaborata da cima a fondo — layout più stretto, caricamento percepito più rapido, stati di convalida più chiari, e rifinito UX di input della carta. In aggregato, questi cambiamenti hanno aumentato i tassi di successo del checkout osservati di circa il 2–3% sul traffico globale.
Cosa è cambiato:
- Interazioni con i campi più fluide — autofocus, ordine di tabulazione più intelligente, e migliorata navigazione via tastiera sul modulo carta
- Stati di errore e caricamento più puliti — la validazione inline si presenta precisamente dove il cliente deve agire, sostituendo il precedente modello di errore del banner del modulo completo
- Pittura più veloce — scheletri e idratazione progressiva eliminano lo sfarfallio dello stato vuoto su reti lente
- Rifinitura mobile — obiettivi di tocco, comportamento di scorrimento, e gestione della tastiera sintonizzati specificamente per il checkout su mobile, dove ora si trova la maggior parte del traffico
Non sono richieste modifiche all’integrazione. Le sessioni di checkout esistenti acquisiscono automaticamente la nuova pagina di pagamento.
5. Rielaborazione del Modulo Prodotto
I flussi di creazione, modifica e duplicazione del prodotto sono stati ricostruiti da zero attorno a un’esperienza di modulo unica e coerente.
Punti salienti:
- Anteprima live — vedi come appare il tuo prodotto sul checkout e il portale clienti mentre modifichi, affiancato al modulo
- Salvataggio automatico — le bozze sono salvate automaticamente, quindi navigare via o perdere la scheda non significa più perdere il lavoro
- Editor Markdown — le descrizioni dei prodotti ora supportano un editor markdown completo con rendering live, anteprime dei link e controlli di formattazione inline
- Parità di flusso duplicato — duplicare un prodotto apre lo stesso modulo unificato precompilato, invece di un dialogo ridotto, così puoi modificare ogni campo prima di salvare la copia
Usa Duplica per creare varianti regionali o di livello di prezzo di un prodotto esistente senza reinserire descrizioni, metadati o configurazione di imballaggio/consegna.
6. Ridisegno della Pagina Impostazioni Business
La pagina Impostazioni → Business è stata ridisegnata per rendere la configurazione più facile da scansionare e più veloce da aggiornare. Le impostazioni sono ora raggruppate in sezioni più chiare con testi esplicativi che descrivono l’impatto di ogni interruttore prima di attivarlo.
Non ci sono cambiamenti comportamentali alle impostazioni esistenti — sono soltanto migliorati layout, raggruppamento e spiegazioni circostanti.
Miglioramenti
credits_amount override ora propagate correttamente alle rotte GET della sessione di checkout e del link pagamento — quando una sessione di checkout o un link di pagamento è stato creato con un override credit_entitlements per checkout, il recupero di quella sessione o link tramite GET restituiva il valore predefinito credits_amount a livello prodotto invece del valore sovrascritto. Questo è ora corretto.- Azione di rimborso disabilitata per pagamenti completamente rimborsati — il pulsante Rimborso su un pagamento è ora disabilitato una volta che un pagamento è completamente rimborsato, con un tooltip che spiega il perché. In precedenza il pulsante rimaneva attivo e restituiva un errore solo dopo la presentazione.
- Correzioni di bug minori e miglioramenti della stabilità in tutta la piattaforma
