curl --request POST \
--url https://hg.cash/api/v1/co/transactions/outbound \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"accountId": "YOUR_ACCOUNT_UUID",
"amount": "50000.00",
"accountType": "cc",
"bankCode": "1001",
"accountNumber": "0000000001",
"beneficiaryFullName": "Ana Ejemplo",
"documentType": "cc",
"documentNumber": "1000000000"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing"
}Crear transacción saliente (Colombia)
Crea un payout en COP desde una cuenta COP operativa.
Omita destinationType o envíe bank para Fast Pay / ACH.
Envíe breb_key o breb_qr para Bre-B.
El éxito es 201 con id y status: processing.
El monto más la comisión de salida debe caber en el saldo neto, o la API responde 409 con code: INSUFFICIENT_NET_BALANCE.
Una cuenta que no es COP responde 400.
Bloqueada o Cerrada responde 403 con code: ACCOUNT_NOT_OPERATIVE.
Restringida responde 403 con code: RESTRICTED.
curl --request POST \
--url https://hg.cash/api/v1/co/transactions/outbound \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"accountId": "YOUR_ACCOUNT_UUID",
"amount": "50000.00",
"accountType": "cc",
"bankCode": "1001",
"accountNumber": "0000000001",
"beneficiaryFullName": "Ana Ejemplo",
"documentType": "cc",
"documentNumber": "1000000000"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing"
}Autorizaciones
Token de autenticación de API de usuario con formato cash_<64-char-hex>. Valor de ejemplo cash_16cdc3b6f83c72d9d2680adca4f430962981f6bf32613a129dded0aa060387d2.
Cuerpo
Payout saliente en COP. Omita destinationType o envíe bank para Fast Pay / ACH.
Banco exige accountType, bankCode, accountNumber (máx. 20), beneficiaryFullName, documentType y documentNumber.
El banco debe admitir Fast Pay o ACH y el tipo de cuenta elegido.
breb_key exige keyValue, beneficiaryFullName, documentType y documentNumber. No envíe campos bancarios.
breb_qr exige qrValue (EMV o base64). Beneficiario y documento son opcionales.
Si el QR trae un monto fijo, amount debe coincidir o la API responde 400 con code: BREB_QR_AMOUNT_MISMATCH.
"YOUR_ACCOUNT_UUID"
Monto positivo. Los valores string admiten como máximo 2 decimales.
x > 0Si se omite, el valor es bank
bank, breb_key, breb_qr Obligatorio para banco. cc corriente, ch ahorros, dp depósito electrónico.
cc, ch, dp Obligatorio para banco. Código de 4 dígitos de GET /co/banks.
^\d{4}$Obligatorio para banco
20Obligatorio para banco y llave Bre-B. Opcional para QR Bre-B.
cc cédula de ciudadanía, nit NIT, ce cédula de extranjería, pa pasaporte, ppt PPT,
ti tarjeta de identidad, rc registro civil, te tarjeta de extranjería,
die documento de identificación extranjero, nd sin documento (Nequi).
La mayoría de los números son solo dígitos. Pasaporte (pa) y PPT (ppt) son alfanuméricos.
nd es solo bancario y solo para el código de banco 1507. documentNumber debe ser ND y phone (E.164) es obligatorio.
nd se rechaza en Bre-B.
cc, nit, ce, pa, ppt, ti, rc, te, die, nd Obligatorio para breb_key
Obligatorio para breb_qr. Payload EMV o base64.
Teléfono E.164 opcional. Obligatorio cuando documentType es nd.
"+570000000000"
"payer@example.com"
40