Skip to main content

​
Resumen

Argentina es el mercado principal de HG.Cash para transferencias bancarias en ARS. HG.Cash asigna cuentas bancarias a sus usuarios en la plataforma. Cuando hay movimientos en esas cuentas—cash-in (entrada) o cash-out (salida)—HG.Cash notifica su backend en la URL de webhook configurada en los ajustes de la cuenta. Para cash-outs, usted inicia transferencias bancarias instantáneas con la API. Para cash-ins, no crea pagos entrantes por API; HG.Cash detecta los movimientos en las cuentas asignadas y los envía a su webhook. Para una página de pago hospedada donde el pagador transfiere a su CVU/alias e ingresa un DNI de 8 dígitos, use Checkout hospedado (country: AR).

​
Cómo funciona

  1. Cuentas — HG.Cash provisiona cuentas ARS (CBU/CVU) vinculadas a su usuario. Use GET /api/v1/accounts y GET /api/v1/account/{id}/balance para saldos y estado.
  2. Cash-in — Las transferencias entrantes se registran y se envían a su webhook (movimientos de cuenta / ledger).
  3. Cash-out — Llame a POST /api/v1/transactions para solicitar un cash-out bancario instantáneo hacia un CBU o CVU. Las actualizaciones de estado llegan por webhook (y opcionalmente webhookUrl por solicitud).
Configure la URL de webhook y el secreto de firma en Ajustes de HG.Cash. Vea Recepción de webhooks para payloads, HMAC y reintentos.

​
Cash-outs (transferencias instantáneas)

Los pagos salientes son solicitudes de transacción a un CBU o CVU del beneficiario. HG.Cash procesa las solicitudes elegibles como cash-outs bancarios instantáneos cuando la cuenta y los límites lo permiten.

​
Requisitos

  • Token Bearer con acceso a la cuenta ARS
  • CBU o CVU del beneficiario (22 dígitos)
  • Saldo neto suficiente en la cuenta origen para el monto de la transferencia más la comisión de salida
HG.Cash calcula la comisión de salida al crear una solicitud de transacción (panel o POST /api/v1/transactions). La solicitud se rechaza si amount + outboundFee supera netBalance (balance - pendingFees de GET /api/v1/account/{id}/balance). Por ejemplo, con netBalance de 1.000.000 ARS y una comisión de salida del 1%, el máximo que puede retirar en una solicitud es 990.000 ARS — no el saldo completo. Si la cuenta no cubre monto y comisión, la API responde 409 con code: INSUFFICIENT_NET_BALANCE y un objeto details que incluye outboundFee, requiredTotal, netBalance y maxWithdrawableAmount.

​
Flujo

  1. Opcional: confirme saldo con GET /api/v1/accounts o GET /api/v1/account/{id}/balance
  2. POST /api/v1/transactions — accountId, amount, toCBU o toCVU
  3. Seguimiento con GET /api/v1/transaction/{id}/status, webhook del panel o webhookUrl en la solicitud
  4. Cuando termine el procesamiento, obtenga la fila de libro con GET /api/v1/transaction-requests/{id}/transaction-id ({ "transactionId": "<uuid>" } o null si aún no está vinculada) o espere el webhook Solicitud de transacción asociada (topic TRANSACTION_REQUEST, eventType transaction_associated)

​
Ejemplo

La respuesta incluye id y status inicial (por ejemplo PENDING). Use webhooks o polling hasta un estado terminal.

​
Error de saldo insuficiente

Cuando el monto solicitado más la comisión de salida supera netBalance, HG.Cash responde 409:
Use maxWithdrawableAmount del error (o consulte el endpoint de saldo antes) para reintentar con un amount menor.

​
Endpoints relacionados

  • GET /api/v1/transaction-requests/{id}/transaction-id — ID de transacción de libro vinculada (null mientras procesa)
  • GET /api/v1/alias-lookup — resolver alias a CBU/CVU (si está habilitado)
  • GET /api/v1/transaction-statuses y GET /api/v1/transaction-types — datos de referencia (sin autenticación)