Transferências bancárias

Visão geral

A Argentina é o mercado principal da HG.Cash para transferências bancárias em ARS. A HG.Cash atribui contas bancárias aos seus usuários na plataforma. Quando há movimentação nessas contas—cash-in (entrada) ou cash-out (saída)—a HG.Cash notifica seu backend na URL de webhook configurada nas definições da conta. Para cash-outs, você inicia transferências bancárias instantâneas pela API. Para cash-ins, não cria recebimentos pela API; a HG.Cash detecta movimentos nas contas atribuídas e os envia ao seu webhook.

Como funciona

Contas — A HG.Cash provisiona contas ARS (CBU/CVU) vinculadas ao seu usuário. Use GET /api/v1/accounts e GET /api/v1/account/{id}/balance para saldos e status.
Cash-in — Transferências recebidas são registradas e enviadas ao seu webhook (movimentos de conta / ledger).
Cash-out — Chame POST /api/v1/transactions para solicitar um cash-out bancário instantâneo para CBU ou CVU do beneficiário. Atualizações de status chegam por webhook (e opcionalmente webhookUrl por solicitação).

Configure a URL de webhook e o segredo de assinatura em Configurações da HG.Cash. Veja Recebimento de webhooks para payloads, HMAC e tentativas.

Cash-outs (transferências instantâneas)

Pagamentos de saída são solicitações de transação para CBU ou CVU do beneficiário. A HG.Cash processa solicitações elegíveis como cash-outs bancários instantâneos quando a conta e os limites permitem.

Pré-requisitos

Token Bearer com acesso à conta ARS
CBU ou CVU do beneficiário (22 dígitos)
Saldo líquido suficiente na conta de origem

Fluxo

Opcional: confirme saldo com GET /api/v1/accounts ou GET /api/v1/account/{id}/balance
POST /api/v1/transactions — accountId, amount, toCBU ou toCVU
Acompanhe com GET /api/v1/transaction/{id}/status, webhook do painel ou webhookUrl na solicitação
Quando o processamento terminar, resolva a linha de ledger com GET /api/v1/transaction-requests/{id}/transaction-id ({ "transactionId": "<uuid>" } ou null enquanto não vinculada) ou aguarde o webhook Solicitação de transação associada (topic TRANSACTION_REQUEST, eventType transaction_associated)

Exemplo

curl -X POST https://hg.cash/api/v1/transactions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "YOUR_ACCOUNT_UUID",
    "toCBU": "1100015400000000000021",
    "amount": 15000.50,
    "toName": "María García",
    "concept": "Pagamento de serviços"
  }'

A resposta inclui id e status inicial (por exemplo PENDING). Use webhooks ou polling até um estado terminal.

Endpoints relacionados

GET /api/v1/transaction-requests/{id}/transaction-id — ID da transação de ledger vinculada (null enquanto processa)
GET /api/v1/alias-lookup — resolver alias para CBU/CVU (se habilitado)
GET /api/v1/transaction-statuses e GET /api/v1/transaction-types — dados de referência (sem autenticação)

​Visão geral

​Como funciona

​Cash-outs (transferências instantâneas)

​Pré-requisitos

​Fluxo

​Exemplo

​Endpoints relacionados