Visão geral
A HG.Cash opera em vários países. Cada mercado tem moeda, meios de pagamento e rotas de API próprios. Use os guias do país em que suas contas estão habilitadas. Conceitos compartilhados—autenticação, contas, saldos e webhooks—são os mesmos em todos os mercados. Os guias por país cobrem cash-in (receber) e payouts (enviar).Status da conta (Brasil, Chile, Bolívia, Colômbia, Venezuela)
As contas têm statusOperativa, Bloqueada ou Cerrada. Para checkouts hospedados (POST /api/v1/checkouts) e APIs diretas de cash-in ou payouts no Brasil, Chile, Bolívia e Colômbia, e para as APIs diretas de cash-in e payouts na Venezuela, apenas contas Operativa podem receber ou enviar fundos. Contas bloqueadas ou encerradas retornam HTTP 403 com code: ACCOUNT_NOT_OPERATIVE.
Use GET /api/v1/accounts ou GET /api/v1/account/{id}/balance para verificar o status antes de criar uma transação ou checkout.
Para uma página de pagamento hospedada unificada na Argentina, Brasil, Chile, Bolívia e Colômbia, use Checkout hospedado (POST /api/v1/checkouts).
Onde operamos
Argentina
ARS — Contas bancárias atribuídas; cash-in e cash-out por webhook; cash-outs instantâneos por API.
Bolívia
BOB — Cash-in com QR e payouts bancários ACH.
Brasil
BRL — PIX com QR / copia e cola para cash-in e payouts por chave PIX.
Chile
CLP — Checkout hospedado para cash-in e payouts bancários.
Colômbia
COP — Checkout hospedado para cash-in, e payouts bancários, chave Bre-B ou QR Bre-B.
Venezuela
USDT — Cash-in e payouts bancários. Os valores são strings decimais USDT.