Perché i metodi di pagamento indiani 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. Ottimo per transazioni ad alto volume e valore inferiore.
Subscription Support
A differenza della maggior parte dei metodi di pagamento alternativi, UPI e Rupay supportano i pagamenti ricorrenti tramite mandati RBI.
Metodi supportati
| Metodo | Tipo | Abbonamenti | Importo minimo |
|---|---|---|---|
| UPI Collect | QR code / VPA | Sì* | ₹1 |
| Rupay Credit | Carta | Sì* | ₹1 |
| Rupay Debit | Carta | Sì* | ₹1 |
Configurazione
Tipi di metodo API
| Tipo | Descrizione |
|---|---|
upi_collect | UPI tramite QR code o inserimento VPA |
credit | Carte di credito incluse Rupay |
debit | Carte di debito incluse Rupay |
Esempio: checkout focalizzato sull’India
Requisiti per UPI
Perché UPI appaia al checkout:- Paese di fatturazione deve essere l’India (
IN) - Valuta deve essere INR
- Per i commercianti non indiani: Adaptive Currency deve essere abilitata
Abbonamenti con mandati RBI
Gli abbonamenti con metodi di pagamento indiani operano sotto le normative RBI (Reserve Bank of India) con requisiti unici.Come funzionano i mandati RBI
Tipi di mandati
| Importo dell’abbonamento | Tipo di mandato | Limite |
|---|---|---|
| Inferiore a Rs 15.000 | Mandato on-demand | Rs 15.000 |
| Rs 15.000 o superiore | Mandato ad importo fisso | Importo esatto dell’abbonamento |
Il ritardo di elaborazione di 48 ore
Questa è la differenza più importante rispetto ai pagamenti con carta internazionali:Pre-Debit Notification
Il cliente riceve una notifica dalla propria banca circa il prossimo addebito.
48-Hour Window
Il cliente può annullare il mandato durante questo periodo tramite la propria app bancaria.
Debit Completed (~48-51 hours)
Dopo 48 ore (più fino a 3 ore aggiuntive per l’elaborazione bancaria), i fondi vengono addebitati.
Gestire la finestra di 48 ore
Eventi webhook per abbonamenti indiani
| Evento | Quando | Azione |
|---|---|---|
subscription.created | Mandato autorizzato | Registra l’inizio dell’abbonamento |
payment.succeeded | ~48h dopo la data di addebito | Concedi/continua l’accesso |
payment.failed | Addebito fallito | Notifica il cliente, sospendi l’accesso |
subscription.on_hold | Pagamento fallito | Invita ad aggiornare il metodo di pagamento |
subscription.active | Riattivato dopo il pagamento | Ripristina l’accesso |
Test
ID di test UPI
| Stato | UPI ID |
|---|---|
| Successo | success@upi |
| Fallimento | failure@upi |
Numeri di test delle carte indiane
| Marca | Scenario | Numero carta | Scadenza | CVV |
|---|---|---|---|---|
| Visa | Successo | 4576238912771450 | 06/32 | 123 |
| Visa | Rifiutata | 4706131211212123 | 06/32 | 123 |
| Mastercard | Successo | 5409162669381034 | 06/32 | 123 |
| Mastercard | Rifiutata | 5105105105105100 | 06/32 | 123 |
Migliori pratiche
Plan for the 48-hour delay
Plan for the 48-hour delay
Progetta la tua applicazione per gestire il divario tra l’inizio dell’addebito e il pagamento effettivo. Considera:
- Periodi di tolleranza per l’accesso all’abbonamento
- Comunicazione chiara ai clienti sui tempi di elaborazione
- Esecuzione basata sui webhook, non sulla data
Handle mandate cancellations
Handle mandate cancellations
I clienti possono cancellare i mandati tramite le loro app bancarie in qualsiasi momento. Monitora i webhook
subscription.on_hold e invita i clienti a ri-sottoscrivere o aggiornare i metodi di pagamento.Set appropriate mandate amounts
Set appropriate mandate amounts
Per prezzi variabili (es. basati sull’utilizzo), considera se un mandato on-demand da Rs 15.000 sia sufficiente. Se gli addebiti potrebbero superare questa soglia, i clienti dovranno ri-autorizzare.
Offer UPI prominently
Offer UPI prominently
Per i clienti indiani, UPI dovrebbe essere l’opzione di pagamento principale. Molti utenti lo preferiscono alle carte per familiarità e minore attrito.
Risoluzione dei problemi
UPI not appearing at checkout
UPI not appearing at checkout
Controlla:
- Paese di fatturazione impostato su
IN? - Valuta impostata su
INR? - Se commerciante non indiano: Adaptive Currency abilitata?
upi_collectincluso inallowed_payment_method_types?
country: "IN" e billing_currency: "INR".Subscription charge failed after upgrade
Subscription charge failed after upgrade
Causa: Il nuovo importo supera il limite del mandato esistente (soglia Rs 15.000).Soluzione: Il cliente deve aggiornare il metodo di pagamento per stabilire 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 o la banca ha rifiutato l’addebito.Soluzione: Il cliente deve ri-autorizzare il mandato o aggiornare il metodo di pagamento.
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
Causa: I ritardi delle API bancarie possono estendere l’elaborazione di 2-3 ore aggiuntive.Soluzione: Questo è previsto. Progetta il sistema per gestire ritardi variabili fino a circa 51 ore in totale.
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
Causa: Caso limite nelle normative RBI — la cancellazione del mandato durante la finestra di elaborazione non annulla immediatamente l’abbonamento.Soluzione: Il prossimo addebito fallirà e l’abbonamento passerà a
on_hold. Monitora i webhook per payment.failed.