Por qué importan los métodos de pago en India
UPI Dominance
UPI procesa 10B+ transacciones/mes. Muchos clientes indios no tienen tarjetas internacionales.
Low Transaction Costs
UPI tiene tarifas de transacción prácticamente nulas. Excelente para transacciones de alto volumen y bajo valor.
Subscription Support
A diferencia de la mayoría de los métodos de pago alternativos, UPI y Rupay admiten pagos recurrentes mediante mandatos del RBI.
Métodos Soportados
| Método | Tipo | Suscripciones | Monto Mínimo |
|---|---|---|---|
| UPI Collect | Código QR / VPA | Sí* | ₹1 |
| Rupay Credit | Tarjeta | Sí* | ₹1 |
| Rupay Debit | Tarjeta | Sí* | ₹1 |
Configuración
Tipos de Métodos API
| Tipo | Descripción |
|---|---|
upi_collect | UPI mediante código QR o entrada de VPA |
credit | Tarjetas de crédito, incluidas Rupay |
debit | Tarjetas de débito, incluidas Rupay |
Ejemplo: Pago Enfocado en India
Requisitos para UPI
Para que UPI aparezca en el checkout:- El país de facturación debe ser India (
IN) - La moneda debe ser INR
- Para comerciantes no indios: Adaptive Currency debe estar habilitado
Suscripciones con Mandatos de RBI
Las suscripciones de métodos de pago indios operan bajo las regulaciones del RBI (Banco de Reserva de India) con requisitos únicos.Cómo Funcionan los Mandatos de RBI
Tipos de Mandatos
| Monto de Suscripción | Tipo de Mandato | Límite |
|---|---|---|
| Menos de Rs 15,000 | Mandato bajo demanda | Rs 15,000 |
| Rs 15,000 o más | Mandato de monto fijo | Monto exacto de suscripción |
El Retraso de Procesamiento de 48 Horas
Esta es la diferencia más importante con respecto a los pagos con tarjetas internacionales:48-Hour Window
El cliente puede cancelar el mandato durante este período a través de su aplicación bancaria.
Debit Completed (~48-51 hours)
Después de 48 horas (más hasta 3 horas adicionales por el procesamiento bancario), se debitan los fondos.
Manejo de la Ventana de 48 Horas
Eventos de Webhook para Suscripciones en India
| Evento | Cuándo | Acción |
|---|---|---|
subscription.active | Mandato autorizado | Registrar inicio de suscripción |
payment.succeeded | ~48 h después de la fecha de cargo | Conceder/continuar acceso |
payment.failed | Débito fallido | Notificar al cliente, pausar acceso |
subscription.on_hold | Pago fallido | Solicitar actualización del método de pago |
subscription.active | Reactivada después del pago | Restaurar acceso |
Pruebas
ID de Prueba de UPI
| Estado | UPI ID |
|---|---|
| Éxito | success@upi |
| Fallo | failure@upi |
Números de Prueba de Tarjeta India
| Marca | Escenario | Número de tarjeta | Expiración | CVV |
|---|---|---|---|---|
| Visa | Éxito | 4576238912771450 | 06/32 | 123 |
| Visa | Rechazada | 4706131211212123 | 06/32 | 123 |
| Mastercard | Éxito | 5409162669381034 | 06/32 | 123 |
| Mastercard | Rechazada | 5105105105105100 | 06/32 | 123 |
Mejores Prácticas
Plan for the 48-hour delay
Plan for the 48-hour delay
Construye tu aplicación para manejar la brecha entre la iniciación del cobro y el pago real. Considera:
- Períodos de gracia para el acceso a la suscripción
- Comunicación clara a los clientes sobre el tiempo de procesamiento
- Cumplimiento impulsado por webhooks, no por fechas
Handle mandate cancellations
Handle mandate cancellations
Los clientes pueden cancelar los mandatos a través de sus aplicaciones bancarias en cualquier momento. Supervisa los webhooks
subscription.on_hold y solicita a los clientes que vuelvan a suscribirse o actualicen sus métodos de pago.Set appropriate mandate amounts
Set appropriate mandate amounts
Para precios variables (por ejemplo, basados en el uso), considera si un mandato bajo demanda de Rs 15,000 es suficiente. Si los cargos podrían superar ese monto, los clientes tendrán que volver a autorizarlo.
Offer UPI prominently
Offer UPI prominently
Para clientes indios, UPI debe ser la opción de pago principal. Muchos usuarios lo prefieren a las tarjetas debido a la familiaridad y la menor fricción.
Solución de Problemas
UPI not appearing at checkout
UPI not appearing at checkout
Verifica:
- ¿El país de facturación está establecido en
IN? - ¿La moneda está configurada en
INR? - Si eres un comerciante no indio: ¿Adaptive Currency está habilitada?
- ¿
upi_collectestá incluido enallowed_payment_method_types?
country: "IN" y billing_currency: "INR".Subscription charge failed after upgrade
Subscription charge failed after upgrade
Causa: El nuevo monto del cobro supera el límite del mandato existente (umbral de Rs 15,000).Solución: El cliente debe actualizar el método de pago para establecer un nuevo mandato con el límite correcto.
Subscription on hold but customer claims they didn't cancel
Subscription on hold but customer claims they didn't cancel
Causa: El cliente pudo haber cancelado el mandato durante la ventana de 48 horas, o su banco rechazó el débito.Solución: El cliente necesita volver a autorizar el mandato o actualizar su método de pago.
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
Causa: Las demoras en la API del banco pueden extender el procesamiento de 2 a 3 horas adicionales.Solución: Esto es esperado. Diseña tu sistema para manejar demoras variables de hasta ~51 horas en total.
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
Causa: Caso límite en las regulaciones del RBI: la cancelación del mandato durante la ventana de procesamiento no cancela inmediatamente la suscripción.Solución: El siguiente cobro fallará y la suscripción pasará a
on_hold. Supervisa los webhooks payment.failed.