Skip to main content

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)

As contas têm status Operativa, Bloqueada ou Cerrada. Para as APIs diretas de entrada/saída e checkouts hospedados (POST /api/v1/checkouts) no Brasil, Chile e Bolívia, 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 e Bolívia, 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.

Chile

CLP — Checkout hospedado para cash-in e payouts bancários.

Brasil

BRL — PIX com QR / copia e cola para cash-in e payouts por chave PIX.

Bolívia

BOB — Cash-in com QR e payouts bancários ACH.

Referência da API

Os endpoints por país estão na aba Referência da API (Transactions para Argentina; Brazil, Chile e Bolivia para cash-in e payouts diretos).