Varför betalningsmetoder i Indien är viktiga
UPI Dominance
UPI behandlar mer än 20 miljarder transaktioner per månad, och många indiska kunder har inget internationellt kort.
Low-Value Payments
UPI accepterar betalningar från ₹5, vilket passar transaktioner med hög volym och lägre värde.
Subscription Support
Till skillnad från de flesta alternativa betalningsmetoder stöder UPI och kort utfärdade i Indien, inklusive Visa, Mastercard och RuPay, återkommande betalningar via RBI-medgivanden.
Metoder som stöds
Tabellen visar varje metod, om den stöder prenumerationer och dess lägsta belopp:
*Prenumerationer kräver RBI-kompatibla medgivanden med särskilda behandlingsregler. Fördröjningen på 48 timmar gäller återkommande debiteringar på alla Indien-utgivna kort och UPI.
En betalning som debiteras i INR måste vara minst ₹5, både för engångsbetalningar och prenumerationer.
Konfiguration
API-metodtyper
Skicka dessa värden iallowed_payment_method_types:
Exempel: Indien-fokuserad Checkout
Den här sessionen erbjuder UPI och kort till en kund i Indien och debiteras i INR:Krav för UPI
UPI visas i Checkout endast när alla dessa villkor är uppfyllda:- Faktureringslandet är Indien (
IN). - Faktureringsvalutan är INR.
- För prenumerationer från handlare utanför Indien är Adaptive Currency aktiverat. Engångsbetalningar behöver inte detta om produkten är prissatt i INR.
Prenumerationer med RBI-medgivanden
Prenumerationer som betalas med UPI eller Indien-utgivna kort använder medgivanden från RBI (Reserve Bank of India), vilket innebär regler som inte gäller för andra betalningsmetoder.Så fungerar RBI-medgivanden
Kunden godkänner ett medgivande när de prenumererar. Varje förnyelsedebitering väntar sedan 48 timmar efter en avisering före debitering innan banken drar pengarna:Typer av medgivanden
Typen av medgivande beror på hur prenumerationsbeloppet förhåller sig till medgivandegränsen:
Beloppet som registreras hos kundens bank är
max(mandate_floor, billing_amount). När faktureringsbeloppet understiger gränsen blir gränsen det kundsynliga godkännandetaket.
Planändringar: Om en uppgradering leder till en debitering över den befintliga medgivandegränsen misslyckas debiteringen och kunden måste godkänna igen.
Konfigurerbar medgivandegräns
Ange medgivandegränsen för INR-e-medgivanden med fältetmandate_min_amount_inr_paise, i INR paise (₹1 = 100 paise).
Du kan åsidosätta systemets standardvärde på ₹15 000 på tre nivåer:
Dodo Payments använder det första angivna värdet: åsidosättningen per begäran, sedan handlarinställningen och därefter systemets standardvärde.
För att ange gränsen skickar du
mandate_min_amount_inr_paise i request body när du skapar en Checkout-session. Den föråldrade slutpunkten Create Subscription accepterar samma fält.
En högre gräns gör att du senare kan göra större engångsdebiteringar, till exempel vid planuppgraderingar eller användningsbaserade övertrasseringar, utan att be kunderna godkänna igen. En lägre gräns håller kundens godkännande närmare det faktiska faktureringsbeloppet, men lämnar mindre utrymme för framtida variabla debiteringar.
Fördröjningen på 48 timmar
En förnyelsedebitering på ett indiskt kort eller med UPI slutförs ungefär 48 timmar efter förnyelsedatumet. Detta är den viktigaste skillnaden jämfört med internationella kortbetalningar:1
Charge Initiated (Day 0)
På det schemalagda förnyelsedatumet initierar Dodo Payments debiteringen hos banken.
2
Pre-Debit Notification
Kundens bank meddelar kunden om den kommande debiteringen.
3
48-Hour Window
Under den här perioden kan kunden avbryta medgivandet i sin bankapp.
4
Debit Completed (~48-51 Hours)
Efter 48 timmar, plus upp till ytterligare 3 timmar för bankens behandling, drar banken pengarna.
5
Webhook Sent
Dodo Payments skickar webhooken
payment.succeeded efter den faktiska debiteringen, inte när debiteringen initieras.Hantera 48-timmarsfönstret
Ge åtkomst från payment webhook, inte från förnyelsedatumet:Webhook-händelser för indiska prenumerationer
Hantera dessa händelser för prenumerationer som betalas med UPI eller Indien-utgivna kort:Testning
UPI-test-ID:n
Ange dessa UPI-ID:n i testläge för att simulera varje resultat:Testnummer för indiska kort
Använd dessa Indien-utgivna testkort:Bästa praxis
Plan for the 48-hour delay
Plan for the 48-hour delay
Bygg din applikation så att den hanterar tiden mellan debiteringens initiering och den faktiska betalningen. Överväg:
- Grace periods för prenumerationsåtkomst
- Tydlig information till kunder om behandlingstiden
- Webhook-driven leverans, inte datumdriven leverans
Handle mandate cancellations
Handle mandate cancellations
Kunder kan när som helst avbryta medgivanden i sina bankappar. Övervaka
subscription.on_hold-webhooks och be kunderna prenumerera igen eller uppdatera sin betalningsmetod.Set appropriate mandate amounts
Set appropriate mandate amounts
För variabel prissättning, till exempel användningsbaserad fakturering, bör du kontrollera om ett medgivande på begäran vid medgivandegränsen (₹15 000 som standard) täcker din största debitering. Om debiteringar kan överstiga den höjer du gränsen med
mandate_min_amount_inr_paise. Annars måste kunderna godkänna ett nytt medgivande.Offer UPI prominently
Offer UPI prominently
För indiska kunder bör du göra UPI till det primära betalningsalternativet. Många föredrar det framför kort eftersom det är välbekant och innebär mindre friktion.
Felsökning
UPI not appearing at checkout
UPI not appearing at checkout
Kontrollera:
- Är faktureringslandet inställt på
IN? - Är faktureringsvalutan inställd på
INR? - Om du är en handlare utanför Indien, är Adaptive Currency aktiverat?
- Ingår
upi_intentiallowed_payment_method_types?
country: "IN" i faktureringsadressen och billing_currency: "INR". Om Adaptive Currency är inaktiverat ignorerar API:t billing_currency, så prissätt produkten i INR istället.Subscription charge failed after upgrade
Subscription charge failed after upgrade
Orsak: Det nya debiteringsbeloppet överstiger den befintliga medgivandegränsen: medgivandegränsen (₹15 000 som standard), eller prenumerationsbeloppet om det är högre.Lösning: Kunden måste uppdatera sin betalningsmetod för att konfigurera ett nytt medgivande med rätt gräns.
Subscription on hold but customer claims they didn't cancel
Subscription on hold but customer claims they didn't cancel
Orsak: Kunden kan ha avbrutit medgivandet under 48-timmarsfönstret, eller så nekade banken debiteringen.Lösning: Kunden måste godkänna medgivandet igen eller uppdatera sin betalningsmetod.
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
Orsak: Fördröjningar i bankens API kan förlänga behandlingen med 2–3 timmar.Lösning: Detta är förväntat. Bygg systemet så att det hanterar förseningar på totalt upp till ungefär 51 timmar.
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
Orsak: Ett specialfall i RBI:s regler: om ett medgivande avbryts under behandlingsfönstret avbryts inte prenumerationen direkt.Lösning: Nästa debitering misslyckas och prenumerationen övergår till
on_hold. Övervaka webhooks efter payment.failed.Relaterade sidor
Payment Methods Overview
Se alla betalningsmetoder som stöds.
Subscriptions
Fullständig dokumentation om prenumerationer, inklusive RBI-medgivanden.
Webhooks
Webhook-hantering för betalningshändelser.
Testing Process
All testdata, inklusive UPI-ID:n och indiska kort.