Adaptador de sandbox para UPI na Índia. Recebimentos reais e liquidação em reais ainda não habilitados.
Esta integração está em preparação. Não aceita pagamentos reais, não converte rúpias para reais e não libera saldo para PIX. A contratação do provedor internacional e a homologação da liquidação BRL ainda são necessárias.
O que foi preparado
O adaptador DLocalInrSandbox permite criar e consultar pagamentos de teste em rúpia indiana (INR), com UPI no fluxo de redirecionamento. Ele se conecta exclusivamente a https://sandbox.dlocal.com, usa HMAC-SHA256 e mantém o mesmo X-Idempotency-Key para o mesmo pedido.O adaptador rejeita execução em produção. Não existe uma chave de configuração que habilite pagamentos reais nesta versão. O provedor internacional é separado do provedor de pagamentos e não altera o processamento dos pagamentos Pix em BRL.Na dashboard, Integrações > Loja de plugins > Recebimentos em rúpias mostra a preparação e as etapas pendentes. Essa área não recebe credenciais do navegador nem oferece ativação de pagamentos reais.
Requisitos do sandbox
Solicite à dLocal uma conta de sandbox habilitada para Índia e UPI. Uma conta de teste não equivale à aprovação comercial para operação como gateway ou plataforma de sublojistas.Configure as credenciais somente no ambiente local do servidor:
Não use prefixo NEXT_PUBLIC_, não inclua credenciais em parâmetros de URL e não coloque essas variáveis de sandbox na implantação de produção.O retorno deve usar HTTPS, sem usuário, senha ou fragmento. O endereço da API não pode ser substituído por uma URL fornecida pelo usuário. As chamadas não seguem redirecionamentos, têm timeout e limitam a resposta a 64 KB.
Valores e dados do pagador
amountMinor é um inteiro em centésimos de rúpia: 10000 representa INR 100,00. Não envie centavos de real nesse campo. Valores fracionários em amountMinor e moedas diferentes de INR são rejeitados.O fluxo exige nome, e-mail, telefone indiano de 10 dígitos, PAN e endereço indiano. O PAN usa o formato de cinco letras, quatro números e uma letra; o CEP deve ter seis dígitos. A validação local verifica o formato, não a existência do PAN ou a identidade do titular. Use exclusivamente os dados de teste aprovados pelo provedor.O arquivo backend/examples/inr-sandbox.json contém dados fictícios para validação local. Ele não representa uma pessoa ou cobrança real.
Validar sem credenciais
Execute a partir da raiz do projeto, com Node.js 22 ou superior e as dependências do backend instaladas:
npm --prefix backend run inr:sandbox -- validate examples/inr-sandbox.json
Esse comando valida o arquivo sem fazer chamadas à dLocal. A saída não inclui os dados pessoais do exemplo.
Criar uma cobrança de teste
Depois de obter as credenciais e os dados de teste do provedor:
npm --prefix backend run inr:sandbox -- create examples/inr-sandbox.json
Para cada nova cobrança, gere um UUID e persista-o em requestId antes da primeira chamada. O mesmo pedido deve conservar requestId e corpo. Depois de um timeout, não crie outro UUID: uma nova chamada explícita com os mesmos dados usa a mesma chave idempotente. O adaptador não repete automaticamente o POST financeiro.A resposta inclui id, requestId, amountMinor, currency, status e redirectUrl. O redirecionamento é aceito somente por HTTPS nos hosts pay.dlocal.com ou sandbox.dlocal.com, sem credenciais embutidas. O link pertence ao teste UPI do provedor; a MingoPay ainda não oferece checkout público em INR.
Consultar o pagamento
Use o ID devolvido pelo sandbox e o mesmo arquivo do pedido:
npm --prefix backend run inr:sandbox -- get examples/inr-sandbox.json PAYMENT_ID_FROM_SANDBOX
A consulta confirma correspondência de ID, pedido, moeda e valor. Não há consulta HTTP periódica. Nesta preparação, a consulta é manual e não existe processamento de webhook internacional publicado.Uma resposta PAID continua retornando environment: sandbox, brlAmountMinor: null, canCreditBrl: false e canPayoutPix: false. Ela não insere lançamentos no saldo, faturamento, extrato financeiro ou metas da MingoPay.
O que falta para produção
Aprovação comercial para a MingoPay e seus sublojistas, país e atividade aceitos pelo parceiro.
Definição da moeda de liquidação, cotação, spread, impostos, tarifas, prazo e regras de devolução.
Onboarding e verificações exigidas para pagadores e recebedores.
Webhooks autenticados, conciliação dos recebimentos e confirmação de liquidação em BRL.
Crédito idempotente no saldo em reais, com reservas e disponibilidade para saque Pix homologadas.
As tarifas domésticas atuais não são aplicadas automaticamente aos pagamentos internacionais. O contrato público e o SDK continuam oferecendo somente as operações documentadas em BRL; não foi adicionado método público de cobrança INR ou de câmbio.