Skip to main content
Acepta UPI y tarjetas emitidas en India, incluidas Visa, Mastercard y RuPay, de clientes en India. UPI representa más del 80 % de las transacciones de pagos digitales de India por volumen. Dodo Payments admite suscripciones en ambos casos mediante mandatos que cumplen con las normas del RBI.

Por qué importan los métodos de pago en India

UPI Dominance

UPI procesa más de 20 mil millones de transacciones al mes y muchos clientes indios no tienen una tarjeta internacional.

Low-Value Payments

UPI acepta pagos desde ₹5, lo que resulta adecuado para transacciones de gran volumen y menor importe.

Subscription Support

A diferencia de la mayoría de los métodos de pago alternativos, UPI y las tarjetas emitidas en India, incluidas Visa, Mastercard y RuPay, admiten pagos recurrentes mediante mandatos del RBI.

Métodos compatibles

La tabla muestra cada método, si admite suscripciones y su importe mínimo: *Las suscripciones requieren mandatos que cumplan con las normas del RBI y reglas especiales de procesamiento. El retraso de procesamiento de 48 horas se aplica a los cargos recurrentes de todas las tarjetas emitidas en India y UPI. Un pago facturado en INR debe ser de al menos ₹5, tanto para pagos únicos como para suscripciones.

Configuración

Tipos de método de API

Pasa estos valores en allowed_payment_method_types:
Checkout ofrece UPI únicamente como upi_intent. Si allowed_payment_method_types incluye upi_collect pero no upi_intent, UPI no aparece en el checkout.

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:
  1. El país de facturación es India (IN).
  2. La moneda de facturación es INR.
  3. 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.
Si eres un merchant fuera de India y Adaptive Currency está deshabilitado, tus clientes no pueden pagar suscripciones con UPI.

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: El importe registrado en el banco del cliente es 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 campo mandate_min_amount_inr_paise, en paise de INR (₹1 = 100 paise).
Esta configuración solo afecta a los e-mandates registrados para tarjetas emitidas en India (Visa, Mastercard y RuPay) en suscripciones en INR. Las suscripciones de UPI siguen su propio flujo de AutoPay y no se ven afectadas.
Puedes sustituir el valor predeterminado del sistema de ₹15,000 en tres niveles: Dodo Payments utiliza el primer valor establecido: primero la sustitución por solicitud, después la configuración del merchant y, por último, el valor predeterminado del sistema. Para establecer el límite inferior, pasa 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 campo acepta estos valores:
Un límite inferior más alto te permite realizar cargos únicos más grandes posteriormente, como actualizaciones de plan o excesos basados en el uso, sin pedir a los clientes que vuelvan a autorizar. Un límite inferior más bajo mantiene la autorización del cliente más cercana al importe de facturación real, pero deja menos margen para futuros cargos variables.

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:
1

Charge Initiated (Day 0)

En la fecha de renovación programada, Dodo Payments inicia el cargo con el banco.
2

Pre-Debit Notification

El banco del cliente le notifica sobre el próximo débito.
3

48-Hour Window

Durante este periodo, el cliente puede cancelar el mandato en su aplicación bancaria.
4

Debit Completed (~48-51 Hours)

Después de 48 horas, más hasta 3 horas adicionales de procesamiento bancario, el banco debita los fondos.
5

Webhook Sent

Dodo Payments envía el webhook payment.succeeded después del débito real, no cuando se inicia el cargo.
No concedas beneficios cuando se inicia el cargo. Espera al webhook payment.succeeded, que llega aproximadamente entre 48 y 51 horas después de la fecha de cargo programada.

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

Diseña tu aplicación para gestionar el intervalo entre el inicio del cargo y el pago real. Considera lo siguiente:
  • 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
Los clientes pueden cancelar mandatos en sus aplicaciones bancarias en cualquier momento. Supervisa los webhooks subscription.on_hold y solicita a los clientes que vuelvan a suscribirse o actualicen su método de pago.
Para precios variables, como la facturación basada en el uso, comprueba si un mandato bajo demanda con el límite inferior del mandato (₹15,000 de forma predeterminada) cubre tu cargo más alto. Si los cargos pueden superarlo, aumenta el límite inferior mediante mandate_min_amount_inr_paise. De lo contrario, los clientes deberán autorizar un nuevo mandato.
Para los clientes indios, convierte UPI en la opción de pago principal. Muchos lo prefieren a las tarjetas porque les resulta familiar y ofrece menos fricción.

Solución de problemas

Comprueba:
  1. ¿El país de facturación está establecido en IN?
  2. ¿La moneda de facturación está establecida en INR?
  3. Si eres un merchant fuera de India, ¿Adaptive Currency está habilitado?
  4. ¿upi_intent está incluido en allowed_payment_method_types?
Solución: Establece 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.
Causa: El importe del nuevo cargo supera el límite del mandato existente: el límite inferior del mandato (₹15,000 de forma predeterminada) o el importe de la suscripción, si este es mayor.Solución: El cliente debe actualizar su método de pago para configurar un nuevo mandato con el límite correcto.
Causa: Es posible que el cliente haya cancelado el mandato durante la ventana de 48 horas o que su banco haya rechazado el débito.Solución: El cliente debe volver a autorizar el mandato o actualizar su método de pago.
Causa: Los retrasos de la API bancaria pueden prolongar el procesamiento entre 2 y 3 horas.Solución: Es un comportamiento esperado. Diseña tu sistema para gestionar retrasos de hasta aproximadamente 51 horas en total.
Causa: Un caso excepcional de las normas del RBI: cancelar un mandato durante la ventana de procesamiento no cancela la suscripción inmediatamente.Solución: El siguiente cargo falla y la suscripción pasa a on_hold. Supervisa los webhooks de payment.failed.

Páginas relacionadas

Payment Methods Overview

Consulta todos los métodos de pago compatibles.

Subscriptions

Consulta la documentación completa de suscripciones, incluidos los mandatos del RBI.

Webhooks

Gestión de webhooks para eventos de pago.

Testing Process

Todos los datos de prueba, incluidos los IDs de UPI y las tarjetas indias.
Última modificación el 28 de septiembre de 2026