{
  "topic": "TRANSACTION",
  "eventType": "created",
  "id": "040eac5b-a998-4879-9d8a-05fd2a08c625",
  "externalID": "E-67REZ8NPQDQ460QK94KVGO-2026-01-14 09:17:21",
  "amount": "12000",
  "currency": "ARS",
  "direction": "Inbound",
  "status": "hecha",
  "type": "inbound",
  "date": "2026-01-14T09:17:21",
  "timezone": "America/Argentina/Buenos_Aires",
  "fromName": "Jose Angel Gallucci",
  "toName": "MUNDO OFERTA IMPORTACIONES S.A",
  "fromCBU": "0000003100117987328844",
  "toCBU": "0000151500037626120131",
  "fromCUIT": "20125680667",
  "toCUIT": "30718891813",
  "coelsaCode": "67REZ8NPQDQ460QK94KVGO",
  "accountId": "843d9d8b-6db8-47a2-8c22-23b198e99c15",
  "feeBreakdown": {
    "flatFee": {
      "amount": "15"
    },
    "collectedAmount": "135"
  }
}

Webhooks

Movimiento de cuenta

HG.Cash enviará este webhook cada vez que entre o salga dinero de una de sus cuentas. El cuerpo de la solicitud contiene los detalles del movimiento.

Úselo para mantener sus saldos internos y libros contables sincronizados con HG.Cash.

Cuando el movimiento tiene un desglose de comisión guardado, el cuerpo incluye feeBreakdown opcional con flatFee.amount y collectedAmount. collectedAmount es el porcentaje cobrado al cliente más la comisión fija. El campo se omite cuando no hay desglose. Los webhooks no incluyen platformFee, transactionFee ni flatFee.source.

Cuando un movimiento PIX de Brasil almacena un identificador end-to-end, el cuerpo incluye endToEndId opcional. El campo se omite si está ausente o vacío. Una actualización posterior que almacena el identificador por primera vez envía un status_change si esa actualización aún no lo notificó. Un identificador que ya estaba almacenado no genera otra entrega por sí solo.

En un payout de Venezuela, status_change se envía cuando el payout llega a done, cuando una retención pending_kyc pasa a processing y cuando esa retención se cancela. Un payout en processing que pasa a cancelled no envía este webhook. Eso incluye un rechazo del proveedor. Cuando se envía un webhook de cancelación, cancelledReason opcional se incluye solo para VE_KYC_EXPIRED, VE_KYC_DECLINED o VE_KYC_REQUIRED. Los demás motivos de cancelación se omiten.

WEBHOOK

account-movement

{
  "topic": "TRANSACTION",
  "eventType": "created",
  "id": "040eac5b-a998-4879-9d8a-05fd2a08c625",
  "externalID": "E-67REZ8NPQDQ460QK94KVGO-2026-01-14 09:17:21",
  "amount": "12000",
  "currency": "ARS",
  "direction": "Inbound",
  "status": "hecha",
  "type": "inbound",
  "date": "2026-01-14T09:17:21",
  "timezone": "America/Argentina/Buenos_Aires",
  "fromName": "Jose Angel Gallucci",
  "toName": "MUNDO OFERTA IMPORTACIONES S.A",
  "fromCBU": "0000003100117987328844",
  "toCBU": "0000151500037626120131",
  "fromCUIT": "20125680667",
  "toCUIT": "30718891813",
  "coelsaCode": "67REZ8NPQDQ460QK94KVGO",
  "accountId": "843d9d8b-6db8-47a2-8c22-23b198e99c15",
  "feeBreakdown": {
    "flatFee": {
      "amount": "15"
    },
    "collectedAmount": "135"
  }
}

Autorizaciones

X-HG-Webhook-Signature

string

header

requerido

Firma HMAC-SHA256 del cuerpo JSON sin procesar. Formato: sha256=<hex>. Cuando configura un secreto de firma de webhooks en la configuración de la cuenta, HG.Cash incluye este encabezado en cada POST de webhook. Verifique la firma en su endpoint para asegurar que la solicitud es auténtica.

Cuerpo

application/json

Carga enviada a su endpoint de webhook cada vez que entra o sale dinero de una de sus cuentas HG.Cash.

Encabezados: Cuando configura un secreto de firma de webhooks en la configuración de la cuenta, HG.Cash envía el encabezado X-HG-Webhook-Signature: sha256=<hex> donde el valor es HMAC-SHA256 del cuerpo JSON sin procesar usando su secreto. Verifíquelo para asegurar que la solicitud es auténtica.

Notas:

Los valores numéricos (como amount, CBU/CUIT) se envían como cadenas para preservar precisión y formato.
date es una fecha y hora local y debe interpretarse usando timezone.

string<uuid>

requerido

ID interno del movimiento

externalID

string

requerido

Identificador externo del proveedor o banco para el movimiento

amount

string

requerido

Monto del movimiento como cadena decimal

currency

string

requerido

Código de moneda ISO 4217

Pattern: ^[A-Z]{3}$

direction

enum<string>

requerido

Dirección del movimiento respecto a su cuenta

Opciones disponibles:

Inbound,

Outbound

status

string

requerido

Estado actual del movimiento

type

string

requerido

Tipo de movimiento (por ejemplo inbound o outbound)

accountId

string<uuid>

requerido

ID de cuenta HG.Cash asociado al movimiento

date

string<date-time>

requerido

Fecha y hora local del movimiento en la zona horaria proporcionada

timezone

string

requerido

Identificador de zona horaria IANA usado para interpretar date

topic

enum<string>

requerido

Tema del webhook para enrutamiento

Opciones disponibles:

TRANSACTION

Ejemplo:

"TRANSACTION"

eventType

enum<string>

requerido

Tipo de evento dentro del tema

Opciones disponibles:

created,

status_change

Ejemplo:

"created"

fromName

string

Nombre del remitente

toName

string

Nombre del destinatario

fromCBU

string

CBU del remitente (22 dígitos). Enviado como cadena.

Pattern: ^\d{22}$

toCBU

string

CBU del destinatario (22 dígitos). Enviado como cadena.

Pattern: ^\d{22}$

fromCUIT

string

CUIT/CUIL del remitente (11 dígitos). Enviado como cadena.

Pattern: ^\d{11}$

toCUIT

string

CUIT/CUIL del destinatario (11 dígitos). Enviado como cadena.

Pattern: ^\d{11}$

coelsaCode

string

Código de transacción Coelsa

endToEndId

string

Identificador end-to-end opcional de un PIX de Brasil almacenado en el movimiento. Se incluye en los webhooks TRANSACTION cuando está presente. Se omite cuando está vacío.

Ejemplo:

"E60701190202505022140DY5DH1K8FL1"

cancelledReason

enum<string>

En un status_change de un payout de Venezuela, se incluye solo para VE_KYC_EXPIRED, VE_KYC_DECLINED o VE_KYC_REQUIRED. Los demás motivos de cancelación se omiten. Un payout en processing que pasa a cancelled no envía este webhook.

Opciones disponibles:

VE_KYC_EXPIRED,

VE_KYC_DECLINED,

VE_KYC_REQUIRED

feeBreakdown

object

Desglose de comisión opcional en un webhook de transacción. Los montos son cadenas decimales. Se omite cuando el movimiento no tiene desglose. collectedAmount es la comisión combinada: el porcentaje cobrado al cliente más la comisión fija. flatFee es solo ese monto fijo. platformFee y transactionFee no se envían aquí; quedan en el estado REST (GET /api/v1/{br,cl,co,ve,bo}/transactions/{id}/status). Los webhooks no incluyen flatFee.source.

Show child attributes