Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.hg.cash/llms.txt

Use this file to discover all available pages before exploring further.

Visão geral

O cash-in no Brasil cria uma cobrança PIX em conta BRL. A API retorna QR code e/ou copia e cola PIX. A transação fica em pending até a confirmação do pagamento. A conta deve ser BRL e país BR.

Pré-requisitos

  • Token Bearer com acesso à conta BRL
  • email do pagador (obrigatório na API)

Fluxo

  1. POST /api/v1/br/transactions/inboundaccountId, amount, email
  2. Exibir qrCode ou pixCopiaECola ao pagador
  3. Opcional: GET /api/v1/br/transactions/{id}/status ou webhookUrl — veja Recebimento de webhooks

Exemplo

curl -X POST https://hg.cash/api/v1/br/transactions/inbound \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "YOUR_ACCOUNT_UUID",
    "amount": 250.00,
    "email": "payer@example.com"
  }'
A transação começa em pending e vai para done quando o PIX é confirmado.