Pular para o conteúdo principal
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:
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:
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:
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.

Referências do provedor