> ## 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.

# Transferencias bancarias

> Cuentas ARS, notificaciones por webhook y cash-outs instantáneos

## 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](/es/developers/checkout)** (`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](/es/developers/receiving-webhooks) (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](/es/developers/receiving-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

### 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**](/api-reference/webhooks/transaction-request-associated) (`topic` `TRANSACTION_REQUEST`, `eventType` `transaction_associated`)

### Ejemplo

```bash theme={null}
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": "Pago de servicios"
  }'
```

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

## 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)