Skip to main content
WEBHOOK

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

Payload enviado a tu endpoint de webhook cuando cambia el estado de un reclamo (actualización de un administrador o autoconciliación por COELSA).

Cabeceras: Cuando configuras un secreto de firma de webhook en la configuración de la cuenta, HG.Cash envía la cabecera X-HG-Webhook-Signature: sha256=<hex>, cuyo valor es el HMAC-SHA256 del cuerpo JSON en crudo usando tu secreto. Verifícalo para asegurar que la solicitud es auténtica.

Notas:

  • Los valores numéricos (como amount) se envían como cadenas para preservar la precisión.
  • fileUrl no se incluye (las URL firmadas expiran).
  • No se envían webhooks al crear un reclamo ni en actualizaciones que solo agregan un comentario.
  • Configura tu URL de webhook en la configuración de usuario.
​
topic
enum<string>
requerido

Tema del webhook para enrutamiento (siempre CLAIM para webhooks de reclamos)

Opciones disponibles:
CLAIM
Ejemplo:

"CLAIM"

​
eventType
enum<string>
requerido

Tipo de evento dentro del tema

Opciones disponibles:
status_change
Ejemplo:

"status_change"

​
id
string<uuid>
requerido

ID del reclamo

​
status
enum<string>
requerido
Opciones disponibles:
OPEN,
UNDER_REVIEW,
RESOLVED,
REJECTED
​
operationNumber
string
requerido
​
coelsaCode
string
requerido
​
amount
string | null
requerido

Monto decimal con 2 decimales

​
currency
enum<string>
requerido
Opciones disponibles:
ARS,
USD,
USDT
​
extractedData
object
requerido
​
originalFilename
string | null
requerido
​
mimeType
string | null
requerido
​
createdAt
string<date-time>
requerido
​
updatedAt
string<date-time>
requerido
​
accountId
string<uuid> | null
​
transactionId
string<uuid> | null

ID de la transacción vinculada cuando la conciliación encontró un match

​
comment
string

Texto del último comentario cuando la actualización de estado incluyó un comentario (se elimina el prefijo de marca de tiempo ISO)