Métodos de Pago en India

Acepta UPI, tarjetas emitidas en India y Apple Pay en INR de clientes en India. Comprende los mandatos de suscripción de RBI, el retraso de 48 horas y los límites de los mandatos.

Acepta UPI, tarjetas emitidas en India (Visa, Mastercard y RuPay) y Apple Pay 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 UPI y tarjetas emitidas en India mediante mandatos que cumplen con 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 es adecuado para transacciones de gran volumen y menor valor.

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 y si admite suscripciones:

Método	Tipo	Suscripciones
UPI	Código QR	Sí*
RuPay Credit	Tarjeta	Sí*
RuPay Debit	Tarjeta	Sí*
Apple Pay	Billetera digital	Sí*

*Las suscripciones requieren mandatos que cumplan con RBI y tienen reglas de procesamiento especiales. El retraso de procesamiento de 48 horas se aplica a los cargos recurrentes en todas las tarjetas emitidas en India, UPI y Apple Pay.

Un pago facturado en INR debe ser de al menos ₹5.00 y, como mínimo, del equivalente en USD: $0.50 para pagos únicos y $1.00 para suscripciones. Consulta Importes mínimos.

​

Configuración

​

Tipos de método de API

Pasa estos valores en allowed_payment_method_types:

Tipo	Descripción
upi_intent	UPI mediante código QR
credit	Tarjetas de crédito, incluida RuPay
debit	Tarjetas de débito, incluida RuPay
apple_pay	Apple Pay en dispositivos Apple. Consulta Apple Pay en India

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, tarjetas y Apple Pay a un cliente en India, con facturación en INR:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: [
    'upi_intent',
    'credit',
    'debit',
    'apple_pay'
  ],
  billing_currency: 'INR',
  customer: {
    email: '[e-mail]',
    name: 'Priya Sharma',
    phone_number: '[phone]'
  },
  billing_address: {
    country: 'IN',
    zipcode: '560001'
  },
  return_url: 'https://example.com/success'
});

​

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:

Importe de la suscripción	Tipo de mandato	Límite
Por debajo del límite inferior del mandato	Mandato bajo demanda	Límite inferior del mandato (₹15,000 de forma predeterminada)
Igual o superior al límite inferior del mandato	Mandato de importe fijo	Importe exacto de la suscripción

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:

Nivel	Dónde establecerlo	Alcance
Por solicitud	mandate_min_amount_inr_paise en una sesión de checkout o suscripción	Una transacción
Merchant	Valor predeterminado a nivel de empresa, si está configurado	Todas tus suscripciones en INR
Sistema	—	Valor predeterminado de ₹15,000

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.

// `client` is an initialized DodoPayments client.
// Per-checkout override
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_inr_monthly', quantity: 1 }],
  mandate_min_amount_inr_paise: 2_000_000, // ₹20,000 ceiling
  return_url: 'https://yoursite.com/return'
});

// Per-subscription override
// Note: POST /subscriptions is deprecated — prefer checkout sessions for new integrations
const subscription = await client.subscriptions.create({
  product_id: 'pdt_inr_monthly',
  quantity: 1,
  customer: { email: '[e-mail]' },
  billing: { country: 'IN', zipcode: '560001' },
  mandate_min_amount_inr_paise: 2_000_000
});

El campo acepta estos valores:

Campo	Tipo	Validación	Se aplica a
mandate_min_amount_inr_paise	integer (paise de INR)	>= 1	Suscripciones en INR con tarjetas indias en conectores que no son Airwallex

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:

// grantPremiumAccess and revokePremiumAccess are your own access-control functions.

// DON'T do this:
async function handleSubscriptionRenewal(subscription) {
  // Bad: Granting access immediately when charge is initiated
  grantPremiumAccess(subscription.customer.customer_id);
}

// DO this:
async function handlePaymentWebhook(event) {
  if (event.type === 'payment.succeeded') {
    // Good: Only grant access after payment is confirmed
    grantPremiumAccess(event.data.customer.customer_id);
  }
  
  if (event.type === 'payment.failed') {
    // Handle failed payment (mandate cancelled, insufficient funds)
    revokePremiumAccess(event.data.customer.customer_id);
  }
}

​

Eventos de webhook para suscripciones indias

Gestiona estos eventos para suscripciones pagadas con UPI o tarjetas emitidas en India:

Evento	Cuándo	Acción
subscription.active	Mandato autorizado	Registrar el inicio de la suscripción
payment.succeeded	~48 h después de la fecha del cargo	Conceder o mantener el acceso
payment.failed	Débito fallido	Notificar al cliente y pausar el acceso
subscription.on_hold	Pago fallido	Solicitar la actualización del método de pago
subscription.active	Reactivada después del pago	Restaurar el acceso

​

Pruebas

​

IDs de prueba de UPI

En el modo de prueba, introduce estos IDs de UPI para simular cada resultado:

Estado	ID de UPI
Éxito	success@upi
Fallo	failure@upi

​

Números de prueba de tarjetas indias

Utiliza estas tarjetas de prueba emitidas en India:

Marca	Escenario	Número de tarjeta	Vencimiento	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

​

Prácticas recomendadas

Plan for the 48-hour delay

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

Handle mandate cancellations

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.

Set appropriate mandate amounts

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.

Offer UPI prominently

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

UPI not appearing at checkout

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.

Subscription charge failed after upgrade

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.

Subscription on hold but customer claims they didn't cancel

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.

Payment deduction delayed beyond 48 hours

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.

Mandate cancelled but subscription still active

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.