Skip to main content
Accetta UPI, carte emesse in India (Visa, Mastercard e RuPay) e Apple Pay dai clienti in India. UPI rappresenta oltre l’80% delle transazioni di pagamento digitali in India in termini di volume. Dodo Payments supporta gli abbonamenti su UPI e sulle carte emesse in India tramite mandati conformi alle normative RBI.

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 in allowed_payment_method_types:
Il checkout offre UPI solo come upi_intent. Se allowed_payment_method_types elenca upi_collect ma non upi_intent, UPI non viene visualizzato nel checkout.

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:
  1. Il paese di fatturazione è l’India (IN).
  2. La valuta di fatturazione è INR.
  3. 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.
Se sei un merchant al di fuori dell’India e Adaptive Currency è disabilitato, i tuoi clienti non possono pagare gli abbonamenti con UPI.

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 campo mandate_min_amount_inr_paise, in paise INR (₹1 = 100 paise).
Questa impostazione influisce solo sugli e-mandate registrati per le carte emesse in India (Visa, Mastercard, RuPay) per gli abbonamenti in INR. Gli abbonamenti UPI seguono il proprio flusso AutoPay e non sono interessati.
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.
Il campo accetta questi valori:
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.
Non concedere i vantaggi quando l’addebito viene avviato. Attendi il webhook payment.succeeded, che arriva circa 48–51 ore dopo la data di addebito pianificata.

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

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
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.
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.
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

Verifica:
  1. Il paese di fatturazione è impostato su IN?
  2. La valuta di fatturazione è impostata su INR?
  3. Se sei un merchant al di fuori dell’India, Adaptive Currency è abilitato?
  4. upi_intent è incluso in allowed_payment_method_types?
Soluzione: imposta 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.
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.
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 2–3 ore.Soluzione: è un comportamento previsto. Progetta il sistema per gestire ritardi complessivi fino a circa 51 ore.
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.
Ultima modifica il 28 settembre 2026