Perché i metodi di pagamento in India sono importanti
UPI Dominance
UPI elabora oltre 20 miliardi di transazioni al mese e molti clienti indiani non dispongono di una carta internazionale.
Low-Value Payments
UPI è adatto alle transazioni ad alto volume e di valore ridotto.
Subscription Support
A differenza della maggior parte dei metodi di pagamento alternativi, UPI e le carte emesse in India, incluse Visa, Mastercard e RuPay, supportano i pagamenti ricorrenti tramite mandati RBI.
Metodi supportati
La tabella elenca ciascun metodo e indica se supporta gli abbonamenti:
*Gli abbonamenti richiedono mandati conformi alle normative RBI con regole di elaborazione speciali. Il ritardo di elaborazione di 48 ore si applica agli addebiti ricorrenti su tutte le carte emesse in India, UPI e Apple Pay.
Un pagamento addebitato in INR deve essere di almeno ₹5.00 e almeno equivalente al minimo in USD: $0.50 per i pagamenti una tantum e $1.00 per gli abbonamenti. Consulta Importi minimi.
Configurazione
Tipi di metodi API
Trasmetti questi valori inallowed_payment_method_types:
Esempio: checkout focalizzato sull’India
Questa sessione offre UPI, carte e Apple Pay a un cliente in India, con addebito in INR:Requisiti per UPI
UPI viene visualizzato nel checkout solo quando tutte queste condizioni sono soddisfatte:- Il paese di fatturazione è l’India (
IN). - La valuta di fatturazione è INR.
- Per gli abbonamenti di merchant al di fuori dell’India, Adaptive Currency è abilitato. I checkout una tantum non ne hanno bisogno se il prodotto ha un prezzo in INR.
Abbonamenti con mandati RBI
Gli abbonamenti pagati con UPI o con carte emesse in India utilizzano mandati RBI (Reserve Bank of India), che aggiungono regole non previste per gli altri metodi di pagamento.Come funzionano i mandati RBI
Il cliente autorizza un mandato quando sottoscrive l’abbonamento. Ogni addebito di rinnovo attende quindi 48 ore dopo una notifica di pre-addebito prima che la banca addebiti i fondi:Tipi di mandato
Il tipo di mandato dipende dal confronto tra l’importo dell’abbonamento e la soglia del mandato:
L’importo registrato presso la banca del cliente è
max(mandate_floor, billing_amount). Quando l’importo di fatturazione è inferiore alla soglia, la soglia diventa il massimale di autorizzazione visibile al cliente.
Modifiche al piano: se un upgrade genera un addebito superiore al limite del mandato esistente, l’addebito non va a buon fine e il cliente deve autorizzare nuovamente il mandato.
Soglia del mandato configurabile
Imposta la soglia del mandato per gli e-mandate in INR con il campomandate_min_amount_inr_paise, in paise INR (₹1 = 100 paise).
Puoi sostituire il valore predefinito di sistema di ₹15.000 a tre livelli:
Dodo Payments utilizza il primo valore impostato: prima la sostituzione per richiesta, poi l’impostazione del merchant e infine il valore predefinito di sistema.
Per impostare la soglia, trasmetti
mandate_min_amount_inr_paise nel corpo della richiesta quando crei una sessione di checkout. L’endpoint Create Subscription, ormai deprecato, accetta lo stesso campo.
Una soglia più alta consente di effettuare in seguito addebiti una tantum più elevati, come upgrade del piano o costi eccedenti basati sull’utilizzo, senza chiedere nuovamente l’autorizzazione ai clienti. Una soglia più bassa mantiene l’autorizzazione del cliente più vicina all’importo effettivo di fatturazione, ma lascia meno margine per futuri addebiti variabili.
Il ritardo di elaborazione di 48 ore
Un addebito di rinnovo su una carta indiana o su UPI viene completato circa 48 ore dopo la data di rinnovo. Questa è la differenza più importante rispetto ai pagamenti con carte internazionali:1
Charge Initiated (Day 0)
Nella data di rinnovo pianificata, Dodo Payments avvia l’addebito presso la banca.
2
Pre-Debit Notification
La banca del cliente lo informa dell’addebito imminente.
3
48-Hour Window
Durante questo periodo, il cliente può annullare il mandato nell’app della propria banca.
4
Debit Completed (~48-51 Hours)
Dopo 48 ore, più fino a 3 ore aggiuntive per l’elaborazione bancaria, la banca addebita i fondi.
5
Webhook Sent
Dodo Payments invia il webhook
payment.succeeded dopo l’addebito effettivo, non quando l’addebito viene avviato.Gestione della finestra di 48 ore
Concedi l’accesso dal webhook di pagamento, non dalla data di rinnovo:Eventi webhook per gli abbonamenti indiani
Gestisci questi eventi per gli abbonamenti pagati con UPI o con carte emesse in India:Test
ID di test UPI
In modalità test, inserisci questi ID UPI per simulare ogni risultato:Numeri di test delle carte indiane
Utilizza queste carte di test emesse in India:Best practice
Plan for the 48-hour delay
Plan for the 48-hour delay
Progetta la tua applicazione per gestire l’intervallo tra l’avvio dell’addebito e il pagamento effettivo. Considera:
- Periodi di tolleranza per l’accesso agli abbonamenti
- Comunicazioni chiare ai clienti sui tempi di elaborazione
- Evasione basata sui webhook, non sulle date
Handle mandate cancellations
Handle mandate cancellations
I clienti possono annullare i mandati nelle app bancarie in qualsiasi momento. Monitora i webhook
subscription.on_hold e invita i clienti a sottoscrivere nuovamente l’abbonamento o ad aggiornare il metodo di pagamento.Set appropriate mandate amounts
Set appropriate mandate amounts
Per i prezzi variabili, come la fatturazione basata sull’utilizzo, verifica se un mandato on-demand con la soglia del mandato (₹15.000 per impostazione predefinita) copre il tuo addebito più elevato. Se gli addebiti potrebbero superarla, aumenta la soglia tramite
mandate_min_amount_inr_paise. In caso contrario, i clienti dovranno autorizzare un nuovo mandato.Offer UPI prominently
Offer UPI prominently
Per i clienti indiani, imposta UPI come opzione di pagamento principale. Molti lo preferiscono alle carte perché è familiare e offre meno frizioni.
Risoluzione dei problemi
UPI not appearing at checkout
UPI not appearing at checkout
Verifica:
- Il paese di fatturazione è impostato su
IN? - La valuta di fatturazione è impostata su
INR? - Se sei un merchant al di fuori dell’India, Adaptive Currency è abilitato?
upi_intentè incluso inallowed_payment_method_types?
country: "IN" nell’indirizzo di fatturazione e billing_currency: "INR". Se Adaptive Currency è disabilitato, l’API ignora billing_currency, quindi assegna al prodotto un prezzo in INR.Subscription charge failed after upgrade
Subscription charge failed after upgrade
Causa: il nuovo importo dell’addebito supera il limite del mandato esistente: la soglia del mandato (₹15.000 per impostazione predefinita) oppure l’importo dell’abbonamento, se superiore.Soluzione: il cliente deve aggiornare il metodo di pagamento per configurare un nuovo mandato con il limite corretto.
Subscription on hold but customer claims they didn't cancel
Subscription on hold but customer claims they didn't cancel
Causa: il cliente potrebbe aver annullato il mandato durante la finestra di 48 ore oppure la banca potrebbe aver rifiutato l’addebito.Soluzione: il cliente deve autorizzare nuovamente il mandato o aggiornare il metodo di pagamento.
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
Causa: i ritardi dell’API bancaria possono prolungare l’elaborazione di 2–3 ore.Soluzione: è un comportamento previsto. Progetta il sistema per gestire ritardi complessivi fino a circa 51 ore.
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
Causa: un caso particolare delle normative RBI: l’annullamento di un mandato durante la finestra di elaborazione non annulla immediatamente l’abbonamento.Soluzione: il prossimo addebito non va a buon fine e l’abbonamento passa a
on_hold. Monitora i webhook per payment.failed.Pagine correlate
Payment Methods Overview
Visualizza tutti i metodi di pagamento supportati.
Subscriptions
Documentazione completa sugli abbonamenti, inclusi i mandati RBI.
Webhooks
Gestione dei webhook per gli eventi di pagamento.
Testing Process
Tutti i dati di test, inclusi gli ID UPI e le carte indiane.