Nuove funzionalità
1. Codici sconto: sconti di importo, pianificazione e regole di idoneità
I codici sconto non sono più limitati alle percentuali. Ora un codice può detrarre un importo fisso, iniziare secondo una pianificazione, avere prezzi diversi per valuta e limitare chi può riscattarlo. Sconti di importo Impostatype su flat per detrarre un importo fisso invece di una percentuale. La detrazione viene applicata al carrello nel suo complesso, anziché a ogni singola riga.
currency_options consente a un singolo codice di comportarsi correttamente con ogni valuta in cui vendi. Ogni voce definisce, per una singola valuta, lo sconto massimo (la detrazione stessa per un codice di tipo Importo, un limite per un codice Percentuale) e il valore minimo del carrello. Uno sconto di tipo Importo richiede almeno un’opzione di valuta con un valore predefinito risolvibile; le opzioni per valuta restano facoltative per gli sconti Percentuale.
Idoneità dei clienti
customer_eligibility controlla chi può riscattare un codice:
GET /discounts/{discount_id}/customers per elencare i clienti associati, POST /discounts/{discount_id}/customers per associarli e DELETE /discounts/{discount_id}/customers/{customer_id} per rimuoverne uno.
Pianificazione e limiti per cliente
Imposta starts_at per pianificare il lancio futuro di un codice — se lo lasci non impostato, il codice rimane attivo immediatamente e deve precedere strettamente expires_at. Usa per_customer_usage_limit per limitare la frequenza con cui un singolo cliente può riscattare un codice, come limite separato che non può superare il valore complessivo di usage_limit.
Il valore minimo del carrello viene sempre calcolato sui prezzi originali del carrello, mai sul totale parziale durante una combinazione di sconti. L’ordine di applicazione degli sconti non cambia quindi il fatto che il minimo sia stato raggiunto.
2. Un’esperienza webhooks ricostruita
La sezione webhooks della dashboard è stata ricostruita come esperienza nativa, sostituendo il portale incorporato. Ora tutto si trova all’interno della dashboard, con tabelle, filtri e navigazione coerenti, e funziona correttamente sui dispositivi mobili.- Endpoint — crea e modifica gli endpoint in un pannello laterale, seleziona i tipi di evento da un albero ricercabile e visualizza immediatamente il tasso di errore delle ultime 24 ore.
- Attività e log — monitora nel tempo i tentativi di consegna nel grafico Attività di consegna, consulta i messaggi consegnati e apri una pagina di dettagli del messaggio per esaminare il payload e ogni tentativo di consegna, con relativo codice di risposta e durata. Ogni tentativo può essere riprodotto da lì.
- Catalogo degli eventi — consulta tutti i tipi di evento inviati da Dodo Payments, con il relativo schema e un payload di esempio.
- Panoramica dell’endpoint — statistiche di consegna delle ultime 24 ore, il signing secret da visualizzare o ruotare e la Cronologia delle riproduzioni.
- Test — invia un evento di esempio a un endpoint per verificare il tuo ricevitore prima di andare live.
- Avanzate — limita la velocità di consegna, gestisci le intestazioni personalizzate inviate con ogni richiesta a quell’endpoint e modifica la relativa trasformazione.
- Riproduzione in blocco — su un endpoint, recupera i messaggi non riusciti, riproduci quelli che non sono mai stati inviati oppure riproduci un intervallo filtrato.
- Avvisi via email — una nuova scheda Impostazioni in cui puoi elencare gli indirizzi a cui inviare un’email quando le consegne a un endpoint iniziano a non riuscire. Separa più indirizzi con virgole e lascia il campo vuoto per disattivare gli avvisi.
Questa modifica riguarda solo la dashboard. I tuoi endpoint esistenti, signing secret, verifica delle firme, nomi degli eventi e payload non cambiano — non è necessario alcun intervento sull’integrazione.
3. Cash App Pay per gli abbonamenti
Ora Cash App Pay può supportare un abbonamento ricorrente, non solo un pagamento una tantum. È disponibile nei checkout statunitensi con addebito in USD, insieme alle opzioni di pagamento con carta già esistenti. Scopri di più: Wallet digitali4. SEPA Direct Debit
SEPA Direct Debit è ora disponibile in tutta l’Eurozona e consente ai clienti di pagare direttamente dal proprio conto bancario invece di usare una carta. È offerto nei checkout in EUR per i pagamenti una tantum. Scopri di più: Metodi di pagamento europei5. Messaggi di errore di pagamento più chiari
Quando un pagamento non va a buon fine, tu e il cliente visualizzate ora un testo scritto appositamente invece del testo grezzo del processore. Ogni errore viene ricondotto a una tassonomia di 46 codici di errore unificati, ciascuno associato a due destinatari:- Tu visualizzi un titolo e un’azione consigliata sul pagamento, così sai se chiedere al cliente di riprovare, contattare la banca o usare un’altra carta.
error_messagesull’oggetto Payment ora contiene questo testo ogni volta cheerror_codeè un codice unificato riconosciuto. - Il cliente visualizza una spiegazione in linguaggio semplice nella schermata di errore del checkout, nel Customer Portal e nelle email di dunning — ad esempio, “Il codice di sicurezza della tua carta (CVC) non sembra corretto. Inseriscilo nuovamente e riprova.”
6. Consenti ai clienti di annullare autonomamente i propri abbonamenti
Consenti l’annullamento dell’abbonamento è ora un’impostazione di primo livello nella scheda Abbonamenti delle impostazioni della dashboard, applicata end-to-end. Quando la disattivi, il Customer Portal disabilita il pulsante di annullamento e l’API rifiuta l’annullamento avviato dal cliente con un403 — sia per l’annullamento immediato sia per il flusso “annulla alla prossima data di fatturazione”. In precedenza l’impostazione nascondeva solo il pulsante, quindi un cliente determinato poteva comunque annullare tramite l’API.
L’impostazione è abilitata per impostazione predefinita. I tuoi annullamenti tramite merchant API e dashboard non sono mai interessati e un cliente può sempre revocare un annullamento già pianificato.
Scopri di più: Customer Portal | Abbonamenti
7. Webhooks dei payout
Ora ricevi webhooks per i tuoi payout, così puoi riconciliarli nei tuoi sistemi contabili senza eseguire polling.payout.created veniva precedentemente emesso come payout.not_initiated. Se un endpoint esistente filtra in base a payout.not_initiated, aggiorna il filtro a payout.created affinché continui a trovare le corrispondenze. Il campo status del payload continua a riportare not_initiated in questa fase.8. Modifica l’email di accesso dalla dashboard
Ora puoi modificare l’indirizzo email con cui accedi, senza contattare l’assistenza. La scheda Account è stata riprogettata e include una nuova sezione Modifica email, con un pulsante Modifica email che avvia il processo. La verifica si svolge in due passaggi: inviamo un codice al tuo indirizzo attuale per confermare la tua identità, quindi un secondo codice al tuo indirizzo nuovo per confermare che ne hai il controllo. Dopo aver verificato entrambi:- Da quel momento accedi con il nuovo indirizzo. Il precedente non funziona più per password, magic link e codici inviati via email.
- Gli eventuali identity provider collegati, come l’accesso con Google o GitHub, vengono scollegati e devono essere ricollegati.
- La password, le attività, l’accesso del team e lo stato di verifica non cambiano.
- Un avviso viene inviato al precedente indirizzo, così una modifica imprevista non passa mai inosservata.
9. Analisi: nuovi widget e perfezionamenti
Sulla base della ricostruzione di Analytics v3, questa release aggiunge nuove visualizzazioni e perfeziona quelle esistenti.- I ricavi per paese sono ora visualizzati in una mappa coropletica a larghezza completa, con l’elenco dei paesi ordinati accanto; la scheda può essere condivisa come le altre.
- Grafici delle tendenze ridisegnati con puntatore a croce al passaggio del mouse, pillola della data scorrevole sull’asse x e tooltip compatto.
- Nuovi intervalli preimpostati — Ultimi 30 giorni sostituisce Ultime 4 settimane e Ultimi 6 mesi si aggiunge all’elenco.
- I tuoi filtri vengono mantenuti. L’intervallo preimpostato e la modalità di confronto ora persistono per attività e ti seguono sui diversi dispositivi, invece di essere ripristinati ai valori predefiniti a ogni sessione.
- I clienti principali vengono identificati per nome, con l’email come fallback.
- I ricavi per paese ora restituiscono fino ai primi 150 paesi.
Miglioramenti e correzioni di bug
10. Filtra i pagamenti per valuta
GET /payments accetta un parametro di query currency facoltativo, così puoi elencare solo i pagamenti regolati in una determinata valuta — ad esempio GET /payments?currency=EUR. Lo stesso filtro è disponibile nella tabella Payments della dashboard.
Scopri di più: Elenca pagamenti
11. Finestra per la risposta alle contestazioni estesa a 10 giorni
Ora hai 10 giorni per rispondere a una contestazione dopo la sua creazione, rispetto ai 4 precedenti. Il conto alla rovescia della contestazione nella dashboard e la scadenza per la risposta restituita dall’API riflettono entrambi la finestra più lunga. Scopri di più: Contestazioni12. Moduli più chiari per i conti bancari dei payout
Aggiungere un conto bancario per i payout è meno ambiguo. Le etichette dei campi, le descrizioni e i tooltip ora si adattano al tipo di attività, così il nome del titolare del conto e quello del beneficiario non risultano più duplicati per le ditte individuali. Selezionando Altro come banca puoi digitare liberamente il nome, il codice bancario nazionale cinese è indicato come CNAPS e la pagina dei payout rimane visibile in modalità test, così puoi raggiungere i conti collegati da entrambe le modalità. Scopri di più: Processo dei payoutAltre correzioni e miglioramenti
- I crediti derivanti dal cambio di piano vengono stornati quando un pagamento non va a buon fine. I crediti di prorata emessi durante il cambio del piano di un abbonamento non rimangono più presenti se il pagamento risultante non va a buon fine.
- Le fatture delle prove a pagamento mostrano l’addebito della prova, non il prezzo ricorrente normale.
- Gli sconti percentuali rispettano il valore minimo del carrello, calcolato sul prezzo base anziché sul totale parziale; inoltre, il timeout del blocco dello sconto ora restituisce un codice di errore distinto invece di un
503generico. - L’eliminazione di un metodo di pagamento già rimosso ora va a buon fine invece di restituire un errore, rendendo la chiamata idempotente in modo sicuro.
- Corretta la valuta utilizzata per la soglia minima del mandato in India durante l’aggiornamento del metodo di pagamento di un abbonamento.
- Le voci del registro crediti oltre i limiti consentiti vengono rifiutate con un
400tipizzato invece di fallire in un secondo momento. - I prodotti Pay-what-you-want supportano un importo fisso nei link di checkout condivisi e gli ID delle entitlement vengono mostrati nel pannello dei dettagli dell’entitlement.
- Correzioni di Analytics: serie del valore nel tempo, add-on inclusi nell’MRR, nessun confronto tra periodi negli intervalli complessivi, serie che si interrompono al bucket attuale ed etichette più chiare per intervalli e confronti.
- Correzioni di bug minori e miglioramenti della stabilità in tutta la piattaforma.