Skip to main content
L’India dispone di un’infrastruttura di pagamento unica, dominata da UPI (oltre il 60% delle transazioni digitali) e dalle carte emesse in India (Visa, Mastercard, Rupay, ecc.). Dodo Payments supporta tutti questi metodi con piena conformità RBI per i mandati degli abbonamenti.

Perché i metodi di pagamento in India sono importanti

UPI Dominance

UPI elabora oltre 10 miliardi di transazioni al mese. Molti clienti indiani non dispongono di carte internazionali.

Low Transaction Costs

UPI ha commissioni di transazione quasi nulle. È eccellente per transazioni ad alto volume e di valore inferiore.

Subscription Support

A differenza della maggior parte dei metodi di pagamento alternativi, UPI e tutte le carte emesse in India (Visa, Mastercard, Rupay, ecc.) supportano i pagamenti ricorrenti tramite mandati RBI.

Metodi supportati

*Gli abbonamenti richiedono mandati conformi alle normative RBI con regole di elaborazione specifiche. Il ritardo di elaborazione di 48 ore si applica a tutte le carte emesse in India e a UPI.

Configurazione

Tipi di metodi API

Esempio: checkout incentrato sull’India

Requisiti per UPI

Affinché UPI venga visualizzato al checkout:
  1. Il paese di fatturazione deve essere l’India (IN)
  2. La valuta deve essere INR
  3. Per i merchant non indiani: Adaptive Currency deve essere abilitato
Se sei un merchant non indiano e Adaptive Currency non è abilitato, UPI non sarà disponibile per i tuoi clienti.

Abbonamenti con mandati RBI

Gli abbonamenti con metodi di pagamento indiani sono soggetti alle normative RBI (Reserve Bank of India) e a requisiti specifici.

Come funzionano i mandati RBI

Tipi di mandato

L’importo registrato presso la banca del cliente è max(mandate_floor, billing_amount). Pertanto, la soglia rappresenta effettivamente il massimale di autorizzazione visibile al cliente quando la fatturazione è inferiore alla soglia. Importante per le modifiche al piano: se un upgrade genera un addebito superiore al limite del mandato esistente, l’addebito non andrà a buon fine e il cliente dovrà autorizzarlo nuovamente.

Soglia del mandato configurabile

La soglia del mandato per gli e-mandate INR è configurabile tramite il campo mandate_min_amount_inr_paise (in paise INR — 1 INR = 100 paise). Puoi sostituire il valore predefinito di sistema di ₹15.000 a tre livelli: Priorità di risoluzione: sostituzione per richiesta → impostazione del merchant → valore predefinito di sistema.
Impostare una soglia più alta consente di supportare in seguito addebiti una tantum più elevati (ad esempio upgrade del piano o eccedenze basate sull’utilizzo) senza costringere i clienti a una nuova autorizzazione. Una soglia più bassa avvicina l’autorizzazione del cliente all’importo effettivamente fatturato, ma riduce il margine disponibile per futuri addebiti variabili.
Questa impostazione influisce solo sugli e-mandate registrati per carte emesse in India (Visa, Mastercard, RuPay) con abbonamenti INR. Gli abbonamenti UPI seguono il proprio flusso AutoPay e non sono interessati.

Il ritardo di elaborazione di 48 ore

Questa è la differenza più importante rispetto ai pagamenti con carte internazionali:
1

Charge Initiated (Day 0)

Alla data di rinnovo programmata, Dodo avvia l’addebito presso la banca.
2

Pre-Debit Notification

Il cliente riceve una notifica dalla propria banca relativa all’addebito imminente.
3

48-Hour Window

Durante questo periodo il cliente può annullare il mandato tramite la propria app bancaria.
4

Debit Completed (~48-51 hours)

Dopo 48 ore (più un massimo di 3 ore aggiuntive per l’elaborazione bancaria), i fondi vengono addebitati.
5

Webhook Sent

Il webhook payment.succeeded viene inviato dopo l’addebito effettivo, non al momento dell’avvio.
Non concedere i vantaggi al momento dell’avvio dell’addebito. Attendi il webhook payment.succeeded, che arriva circa 48-51 ore dopo la data programmata dell’addebito.

Gestione della finestra di 48 ore

Eventi webhook per gli abbonamenti indiani

Test

ID di test UPI

Numeri di test delle carte indiane

Best practice

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 guidata dai webhook, non dalle date
I clienti possono annullare i mandati tramite le app bancarie in qualsiasi momento. Monitora i webhook subscription.on_hold e invita i clienti a sottoscrivere nuovamente l’abbonamento o ad aggiornare i metodi di pagamento.
Per i prezzi variabili (ad esempio, basati sull’utilizzo), valuta se un mandato on-demand di 15.000 Rs sia sufficiente. Se gli addebiti potrebbero superare questo importo, i clienti dovranno autorizzare nuovamente il mandato.
Per i clienti indiani, UPI dovrebbe essere l’opzione di pagamento principale. Molti utenti lo preferiscono alle carte per la familiarità e la maggiore semplicità.

Risoluzione dei problemi

Verifica:
  1. Il paese di fatturazione è impostato su IN?
  2. La valuta è impostata su INR?
  3. Se il merchant non è indiano: Adaptive Currency è abilitato?
  4. upi_collect è incluso in allowed_payment_method_types?
Soluzione: verifica che l’indirizzo di fatturazione contenga country: "IN" e billing_currency: "INR".
Causa: il nuovo importo dell’addebito supera il limite del mandato esistente (soglia di 15.000 Rs).Soluzione: il cliente deve aggiornare il metodo di pagamento per stabilire un nuovo mandato con il limite corretto.
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.
Causa: i ritardi dell’API bancaria possono prolungare l’elaborazione di altre 2-3 ore.Soluzione: è un comportamento previsto. Progetta il sistema per gestire ritardi variabili fino a circa 51 ore complessive.
Causa: caso limite nelle normative RBI: l’annullamento del mandato durante la finestra di elaborazione non annulla immediatamente l’abbonamento.Soluzione: il prossimo addebito non andrà a buon fine e l’abbonamento passerà 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.
Ultima modifica il 6 agosto 2026