Chile (CLP)

O Chile aceita três trilhos de entrada, todos no mesmo endpoint e com a mesma página hospedada — muda só o paymentMethod, que define o que o comprador vê na página:

Omitir paymentMethod usa BANK_TRANSFER. Os três compartilham o mesmo request e o mesmo fluxo de redirect; para o seu código, a única diferença é a string do método.

Dados do pagador: os três métodos exigem name, email e o RUT (em responsibleDocument). O phone é recomendado, não obrigatório. Veja o RUT logo abaixo.

Faixa da rede: CLP$ 1.000 a CLP$ 5.000.000 por transação — limites estimados, sujeitos a confirmação da rede chilena.

O RUT (Rol Único Tributario) é o documento tributário do pagador chileno — o equivalente ao CPF. No Chile ele é obrigatório nos três métodos e vai em responsibleDocument.

Diferente de outros países, o RUT é validado pelo dígito verificador (módulo 11) antes da cobrança ser criada: um RUT inválido é recusado com 400, sem ir à rede. Formatos aceitos — com ou sem pontos, com hífen antes do dígito:

• 12.345.678-5
• 12345678-5
• 123456785

O dígito verificador (o último caractere) pode ser um número ou a letra K (ex.: 15.330.948-K). Se a sua tela tem um campo de documento, não force teclado numérico nem máscara de CPF no Chile — o K precisa ser digitável.

No checkout hospedado da Pagnovo isso já é tratado: em contas CLP o campo pede RUT, valida o dígito e normaliza antes de enviar. Pela API, mande o RUT em responsibleDocument em qualquer um dos formatos acima.

Limites da rede: mínimo CLP$ 1.000 e máximo CLP$ 5.000.000 por transação (estimados).

O peso chileno não tem centavos — mas amount continua em centavos, como em todas as moedas. CLP$ 1.000 é 100000, não 1000; CLP$ 5.000 é 500000. Mande sempre múltiplos de 100 (uma fração de peso é arredondada para o peso inteiro antes de ir à rede).

curl -X POST "https://api.pagnovo.com/transactions/v2/purchase" \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Matías González",
    "email": "matias@ejemplo.cl",
    "amount": 500000,
    "currency": "CLP",
    "paymentMethod": "BANK_TRANSFER",
    "description": "Suscripción Pro",
    "responsibleDocument": "12.345.678-5",
    "responsibleExternalId": "user-1234",
    "postbackUrl": "https://seu-dominio.com/webhook"
  }'

Resposta — o redirectUrl já vem preenchido:

{
  "id": "17864385245624641191295936",
  "currency": "CLP",
  "method": "BANK_TRANSFER",
  "status": "PENDING",
  "amount": 500000,
  "redirectUrl": "https://checkout.magenpay.io/checkout/9f2c1e40",
  "expiresAt": "2026-10-23T09:25:24.748Z",
  "createdAt": "2026-10-23T08:55:24.748Z"
}

amount é 500000 = CLP$ 5.000 (centavos, apesar de o peso não ter centavos). Redirecione o comprador para o redirectUrl assim que a cobrança for criada — não há polling. Troque paymentMethod por "CARD" ou "WALLET" para os outros meios; o fluxo é idêntico.

O status fica PENDING até o pagamento cair; a confirmação chega pelo webhook cashin.paid (mesmo evento do PIX). Não existe cash-out em pesos chilenos: o saldo em CLP é liquidado para BRL pela Pagnovo e você saca em real — veja Como esse dinheiro vira saque, logo abaixo.

Cash-out em pesos chilenos não existe: todo saque da plataforma sai em BRL, por PIX. O caminho do dinheiro é sempre o mesmo:

1. O comprador paga e o saldo entra em CLP.
2. A Pagnovo liquida esse saldo para BRL pela cotação de câmbio do dia.
3. O valor em BRL passa a aparecer no seu saldo e você saca pelo fluxo normal — POST /withdraws/cash-out, o mesmo de uma conta brasileira.

Você não faz nada no passo 2. Não existe endpoint de conversão, não precisa abrir chamado nem aprovar cotação — a liquidação é operada pela Pagnovo e o saldo em BRL simplesmente aparece. Do lado da sua integração, o Chile é só mais uma moeda de entrada: você cobra em CLP e saca em BRL como sempre fez.

O que muda pro seu fluxo de caixa: enquanto o saldo estiver em CLP, ele ainda não é sacável — só o saldo em BRL é. Consulte os dois em GET /accounts/balances, que devolve uma linha por moeda, e programe o saque em cima da linha de BRL.