Por que os métodos de pagamento da Índia importam
UPI Dominance
O UPI processa mais de 10 bilhões de transações por mês. Muitos clientes indianos não possuem cartões internacionais.
Low Transaction Costs
O UPI tem taxas de transação quase zero. Excelente para transações de alto volume e baixo valor.
Subscription Support
Ao contrário da maioria dos métodos de pagamento alternativos, UPI e Rupay suportam pagamentos recorrentes via mandatos do RBI.
Métodos suportados
| Método | Tipo | Assinaturas | Valor mínimo |
|---|---|---|---|
| UPI Collect | QR code / VPA | Sim* | ₹1 |
| Rupay Credit | Card | Sim* | ₹1 |
| Rupay Debit | Card | Sim* | ₹1 |
Configuração
Tipos de método de API
| Tipo | Descrição |
|---|---|
upi_collect | UPI via QR code ou entrada de VPA |
credit | Cartões de crédito incluindo Rupay |
debit | Cartões de débito incluindo Rupay |
Exemplo: Checkout focado na Índia
Requisitos para UPI
Para que o UPI apareça no checkout:- País de cobrança deve ser Índia (
IN) - Moeda deve ser INR
- Para comerciantes não indianos: Moeda Adaptativa deve estar habilitada
Assinaturas com mandatos do RBI
As assinaturas com métodos de pagamento indianos operam sob as regulamentações do RBI (Reserve Bank of India) com requisitos exclusivos.Como funcionam os mandatos do RBI
Tipos de mandato
| Valor da assinatura | Tipo de mandato | Limite |
|---|---|---|
| Abaixo de Rs 15.000 | Mandato sob demanda | Rs 15.000 |
| Rs 15.000 ou mais | Mandato de valor fixo | Valor exato da assinatura |
O atraso de processamento de 48 horas
Esta é a diferença mais importante em relação aos pagamentos com cartão internacional:Debit Completed (~48-51 hours)
Após 48 horas (mais até 3 horas adicionais para processamento bancário), os fundos são debitados.
Lidando com a janela de 48 horas
Eventos de webhook para assinaturas indianas
| Evento | Quando | Ação |
|---|---|---|
subscription.created | Mandato autorizado | Registre o início da assinatura |
payment.succeeded | ~48h após a data de cobrança | Conceda/continue o acesso |
payment.failed | Débito falhou | Notifique o cliente, pause o acesso |
subscription.on_hold | Pagamento falhou | Solicite atualização do método de pagamento |
subscription.active | Reativado após pagamento | Restaure o acesso |
Testes
IDs de teste UPI
| Status | ID UPI |
|---|---|
| Sucesso | success@upi |
| Falha | failure@upi |
Números de cartão de teste indianos
| Bandeira | Cenário | Número do cartão | Validade | CVV |
|---|---|---|---|---|
| Visa | Sucesso | 4576238912771450 | 06/32 | 123 |
| Visa | Recusado | 4706131211212123 | 06/32 | 123 |
| Mastercard | Sucesso | 5409162669381034 | 06/32 | 123 |
| Mastercard | Recusado | 5105105105105100 | 06/32 | 123 |
Melhores práticas
Plan for the 48-hour delay
Plan for the 48-hour delay
Construa seu aplicativo para lidar com a lacuna entre a iniciação da cobrança e o pagamento real. Considere:
- Períodos de carência para acesso à assinatura
- Comunicação clara aos clientes sobre o tempo de processamento
- Atendimento acionado por webhook, não por data
Handle mandate cancellations
Handle mandate cancellations
Os clientes podem cancelar mandatos via apps bancários a qualquer momento. Monitore
subscription.on_hold webhooks e incentive os clientes a se reinscreverem ou atualizarem seus métodos de pagamento.Set appropriate mandate amounts
Set appropriate mandate amounts
Para preços variáveis (por exemplo, baseados em uso), considere se um mandato sob demanda de Rs 15.000 é suficiente. Se as cobranças puderem exceder isso, os clientes precisarão reautorizar.
Offer UPI prominently
Offer UPI prominently
Para clientes indianos, o UPI deve ser a opção de pagamento principal. Muitos usuários o preferem aos cartões devido à familiaridade e menor atrito.
Solução de problemas
UPI not appearing at checkout
UPI not appearing at checkout
Verifique:
- País de cobrança definido para
IN? - Moeda configurada para
INR? - Se for comerciante não indiano: Moeda Adaptativa habilitada?
upi_collectincluído emallowed_payment_method_types?
country: "IN" e billing_currency: "INR".Subscription charge failed after upgrade
Subscription charge failed after upgrade
Causa: Novo valor de cobrança excede o limite do mandato existente (limite de Rs 15.000).Solução: O cliente deve atualizar o método de pagamento para estabelecer um novo mandato com o limite correto.
Subscription on hold but customer claims they didn't cancel
Subscription on hold but customer claims they didn't cancel
Causa: O cliente pode ter cancelado o mandato durante a janela de 48 horas, ou o banco recusou o débito.Solução: O cliente precisa reautorizar o mandato ou atualizar o método de pagamento.
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
Causa: Atrasos na API do banco podem estender o processamento por mais 2-3 horas.Solução: Isso é esperado. Estruture seu sistema para lidar com atrasos variáveis de até ~51 horas no total.
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
Causa: Caso extremo nas regulamentações do RBI — o cancelamento do mandato durante a janela de processamento não cancela imediatamente a assinatura.Solução: A próxima cobrança falhará e a assinatura passará para
on_hold. Monitore webhooks para payment.failed.