> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mingopay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Rúpias (INR): preparação

> Adaptador de sandbox para UPI na Índia. Recebimentos reais e liquidação em reais ainda não habilitados.

> [!WARNING]
>
> 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:

```dotenv theme={"system"}
DLOCAL_SANDBOX_LOGIN=replace-with-sandbox-login
DLOCAL_SANDBOX_TRANS_KEY=replace-with-sandbox-trans-key
DLOCAL_SANDBOX_SECRET_KEY=replace-with-sandbox-secret-key
DLOCAL_SANDBOX_CALLBACK_URL=https://merchant.example/callback
```

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:

```bash theme={"system"}
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:

```bash theme={"system"}
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:

```bash theme={"system"}
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.

## Referências do provedor

* [Índia e UPI](https://docs.dlocal.com/docs/india)
* [Credenciais de API](https://docs.dlocal.com/docs/get-api-credentials)
* [Assinatura de requisições](https://docs.dlocal.com/reference/payins-security)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.