Varför betalningsmetoder i Indien är viktiga
UPI Dominance
UPI hanterar över 10 miljarder transaktioner per månad. Många indiska kunder har inte internationella kort.
Low Transaction Costs
UPI har nästan inga transaktionsavgifter. Utmärkt för transaktioner med hög volym och lägre värde.
Subscription Support
Till skillnad från de flesta alternativa betalningsmetoder stöder UPI och alla kort utfärdade i Indien (Visa, Mastercard, Rupay med flera) återkommande betalningar via RBI-mandat.
Metoder som stöds
*Prenumerationer kräver RBI-kompatibla mandat med särskilda behandlingsregler. 48-timmarsfördröjningen för behandling gäller alla kort utfärdade i Indien och UPI.
Konfiguration
API-metodtyper
Exempel: Indienfokuserad checkout
Krav för UPI
För att UPI ska visas i checkout:- Faktureringsland måste vara Indien (
IN) - Valutan måste vara INR
- För icke-indiska merchants: Adaptive Currency måste vara aktiverat
Prenumerationer med RBI-mandat
Prenumerationer med indiska betalningsmetoder omfattas av RBI:s (Reserve Bank of India) regler och har särskilda krav.Så fungerar RBI-mandat
Mandattyper
Beloppet som registreras hos kundens bank är
max(mandate_floor, billing_amount). Golvet är därför i praktiken kundens auktoriseringstak när faktureringen är lägre än golvet.
Viktigt vid plänändringar: Om en uppgradering leder till en debitering som överstiger det befintliga mandatets gräns kommer debiteringen att misslyckas och kunden måste auktorisera på nytt.
Konfigurerbart mandatgolv
Mandatgolvet för INR-e-mandat kan konfigureras via fältetmandate_min_amount_inr_paise (i INR paise — 1 INR = 100 paise). Du kan åsidosätta systemets standardvärde på ₹15 000 på tre nivåer:
Prioritetsordning: åsidosättning per begäran → merchant-inställning → systemstandard.
Med ett högre golv kan du senare stödja större engångsdebiteringar (till exempel plänuppgraderingar eller användningsbaserade tillägg) utan att tvinga kunderna att auktorisera på nytt. Ett lägre golv kopplar kundens auktorisering närmare det faktiska faktureringsbeloppet, men begränsar utrymmet för framtida varierande debiteringar.
48-timmarsfördröjningen för behandling
Detta är den viktigaste skillnaden jämfört med internationella kortbetalningar:1
Charge Initiated (Day 0)
På det schemalagda förnyelsedatumet initierar Dodo debiteringen hos banken.
2
Pre-Debit Notification
Kunden får en avisering från sin bank om den kommande debiteringen.
3
48-Hour Window
Kunden kan avbryta mandatet under denna period via sin bankapp.
4
Debit Completed (~48-51 hours)
Efter 48 timmar (plus upp till ytterligare 3 timmar för bankens behandling) debiteras pengarna.
5
Webhook Sent
En
payment.succeeded-webhook skickas efter den faktiska debiteringen, inte vid initieringen.Hantera 48-timmarsfönstret
Webhook-händelser för indiska prenumerationer
Testning
UPI-test-ID:n
Testnummer för indiska kort
Bästa praxis
Plan for the 48-hour delay
Plan for the 48-hour delay
Bygg din applikation så att den hanterar tiden mellan initieringen av debiteringen och den faktiska betalningen. Överväg:
- Grace periods för prenumerationsåtkomst
- Tydlig kommunikation till kunder om behandlingstiden
- Webhook-styrd leverans, inte datumstyrd
Handle mandate cancellations
Handle mandate cancellations
Kunder kan när som helst avbryta mandat via sina bankappar. Övervaka
subscription.on_hold-webhooks och uppmana kunder att prenumerera på nytt eller uppdatera betalningsmetoder.Set appropriate mandate amounts
Set appropriate mandate amounts
För varierande prissättning (till exempel användningsbaserad) bör du överväga om ett on-demand-mandat på 15 000 Rs är tillräckligt. Om debiteringarna kan överstiga detta måste kunderna auktorisera på nytt.
Offer UPI prominently
Offer UPI prominently
För indiska kunder bör UPI vara det primära betalningsalternativet. Många användare föredrar det framför kort eftersom de är vana vid det och friktionen är lägre.
Felsökning
UPI not appearing at checkout
UPI not appearing at checkout
Kontrollera:
- Är faktureringslandet inställt på
IN? - Är valutan inställd på
INR? - Om merchant inte är indisk: är Adaptive Currency aktiverat?
- Ingår
upi_collectiallowed_payment_method_types?
country: "IN" och billing_currency: "INR".Subscription charge failed after upgrade
Subscription charge failed after upgrade
Orsak: Det nya debiteringsbeloppet överstiger den befintliga mandatgränsen (tröskel på 15 000 Rs).Lösning: Kunden måste uppdatera betalningsmetoden för att skapa ett nytt mandat 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 mandatet under 48-timmarsfönstret, eller så nekade banken debiteringen.Lösning: Kunden måste auktorisera mandatet på nytt eller uppdatera betalningsmetoden.
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 ytterligare 2–3 timmar.Lösning: Detta är förväntat. Bygg systemet så att det hanterar varierande fördröjningar på upp till cirka 51 timmar totalt.
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
Orsak: Ett specialfall i RBI-reglerna — att mandatet avbryts under behandlingsfönstret avslutar inte prenumerationen omedelbart.Lösning: Nästa debitering kommer att misslyckas och prenumerationen flyttas 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-mandat.
Webhooks
Hantering av webhooks för betalningshändelser.
Testing Process
Alla testdata, inklusive UPI-ID:n och indiska kort.