Criar checkouts

​

Painel

1. Abra Checkouts na barra lateral (/app/checkouts).
2. Revise a linha de estatísticas e as sessões recentes no resumo.
3. Em Criar checkout, escolha país, conta (opcional — a HG.Cash escolhe uma conta operativa elegível se omitida), valor e URL de sucesso.
4. Clique em Criar checkout. Copie o link do checkout no painel de sucesso e envie ao pagador.

​

Notas por país (painel)

​

API

{
  "country": "AR",
  "amount": "1500.00",
  "successUrl": "https://merchant.example/success"
}

​

Argentina (AR)

• A resposta inclui accountDisplay (alias, CVU/CBU, titular).
• O pagador preenche nome, valor e DNI de 8 dígitos na página hospedada.
• Conclusão quando uma transferência de entrada coincide valor + DNI na conta atribuída.

​

Brasil (BR)

• payer.name, payer.document (CPF ou CNPJ — somente dígitos ou com pontuação) e payer.email obrigatórios na criação.
• A resposta pode incluir qrCode e pixCopiaECola.

​

Chile (CL)

• paymentMethodId e customer obrigatórios — veja Cash-in Chile para listar métodos de pagamento.

​

Exemplo (Brasil)

curl -X POST https://hg.cash/api/v1/checkouts \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "BR",
    "amount": "100.50",
    "successUrl": "https://merchant.example/success",
    "payer": {
      "name": "Federico Autuori",
      "document": "957.937.532-14",
      "email": "fautuori@gmail.com"
    }
  }'

​

Exemplo (Argentina)

curl -X POST https://hg.cash/api/v1/checkouts \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "AR",
    "amount": "1500.00",
    "successUrl": "https://merchant.example/success",
    "cancelUrl": "https://merchant.example/cancel",
    "webhookUrl": "https://merchant.example/hooks/checkout",
    "metadata": { "orderId": "ORD-42" }
  }'

​

Relacionado

• Introdução — Status e webhooks
• Validar pagamentos
• Conciliar checkouts
• Referência da API → Checkouts → Create checkout session