Por qué importan los métodos de pago en India
UPI Dominance
Low-Value Payments
Subscription Support
Métodos compatibles
La tabla muestra cada método, si admite suscripciones y su importe mínimo:Configuración
Tipos de método de API
Pasa estos valores enallowed_payment_method_types:
Ejemplo: checkout centrado en India
Esta sesión ofrece UPI y tarjetas a un cliente en India, con facturación en INR:Requisitos para UPI
UPI aparece en el checkout únicamente cuando se cumplen todas estas condiciones:- El país de facturación es India (
IN). - La moneda de facturación es INR.
- Para suscripciones de merchants fuera de India, Adaptive Currency está habilitado. Los checkouts únicos no lo necesitan si el producto tiene un precio en INR.
Suscripciones con mandatos del RBI
Las suscripciones pagadas con UPI o tarjetas emitidas en India funcionan con mandatos del RBI (Reserve Bank of India), que añaden reglas que no tienen otros métodos de pago.Cómo funcionan los mandatos del RBI
El cliente autoriza un mandato al suscribirse. Cada cargo de renovación espera 48 horas después de una notificación de pre débito antes de que el banco debite los fondos:Tipos de mandato
El tipo de mandato depende de cómo se compara el importe de la suscripción con el límite inferior del mandato:max(mandate_floor, billing_amount). Cuando el importe de facturación está por debajo del límite, este se convierte en el límite de autorización visible para el cliente.
Cambios de plan: Si una actualización genera un cargo superior al límite del mandato existente, el cargo falla y el cliente debe autorizarlo de nuevo.
Límite inferior configurable del mandato
Establece el límite inferior de los e-mandates en INR con el campomandate_min_amount_inr_paise, en paise de INR (₹1 = 100 paise).
Puedes sustituir el valor predeterminado del sistema de ₹15,000 en tres niveles:
mandate_min_amount_inr_paise en el cuerpo de la solicitud al crear una sesión de checkout. El endpoint obsoleto Create Subscription acepta el mismo campo.
El retraso de procesamiento de 48 horas
Un cargo de renovación en una tarjeta india o UPI se completa aproximadamente 48 horas después de la fecha de renovación. Esta es la diferencia más importante respecto a los pagos con tarjetas internacionales:Charge Initiated (Day 0)
Pre-Debit Notification
48-Hour Window
Debit Completed (~48-51 Hours)
Webhook Sent
payment.succeeded después del débito real, no cuando se inicia el cargo.Gestión de la ventana de 48 horas
Concede acceso desde el webhook de pago, no desde la fecha de renovación:Eventos de webhook para suscripciones indias
Gestiona estos eventos para suscripciones pagadas con UPI o tarjetas emitidas en India:Pruebas
IDs de prueba de UPI
En el modo de prueba, introduce estos IDs de UPI para simular cada resultado:Números de prueba de tarjetas indias
Utiliza estas tarjetas de prueba emitidas en India:Prácticas recomendadas
Plan for the 48-hour delay
Plan for the 48-hour delay
- Periodos de gracia para el acceso a suscripciones
- Comunicación clara a los clientes sobre el tiempo de procesamiento
- Cumplimiento impulsado por webhooks, no por fechas
Handle mandate cancellations
Handle mandate cancellations
subscription.on_hold y solicita a los clientes que vuelvan a suscribirse o actualicen su método de pago.Set appropriate mandate amounts
Set appropriate mandate amounts
mandate_min_amount_inr_paise. De lo contrario, los clientes deberán autorizar un nuevo mandato.Offer UPI prominently
Offer UPI prominently
Solución de problemas
UPI not appearing at checkout
UPI not appearing at checkout
- ¿El país de facturación está establecido en
IN? - ¿La moneda de facturación está establecida en
INR? - Si eres un merchant fuera de India, ¿Adaptive Currency está habilitado?
- ¿
upi_intentestá incluido enallowed_payment_method_types?
country: "IN" en la dirección de facturación y billing_currency: "INR". Si Adaptive Currency está deshabilitado, la API ignora billing_currency, así que establece el precio del producto en INR.Subscription charge failed after upgrade
Subscription charge failed after upgrade
Subscription on hold but customer claims they didn't cancel
Subscription on hold but customer claims they didn't cancel
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
on_hold. Supervisa los webhooks de payment.failed.