Evento de checkout

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 cuando una sesión de checkout hospedado cambia de estado

topic

enum<string>

requerido

Tema del webhook para enrutamiento

Opciones disponibles:

CHECKOUT

Ejemplo:

"CHECKOUT"

eventType

enum<string>

requerido

Tipo de evento (coincide con event)

Opciones disponibles:

checkout.completed,

checkout.awaiting_manual_review,

checkout.rejected

Ejemplo:

"checkout.completed"

string<uuid>

requerido

ID de la sesión de checkout

status

string

requerido

Estado del checkout después del evento

event

enum<string>

requerido

Opciones disponibles:

checkout.completed,

checkout.awaiting_manual_review,

checkout.rejected

amount

string

requerido

Monto decimal como cadena

currency

string

requerido

Código de moneda ISO 4217

country

enum<string>

requerido

Opciones disponibles:

AR,

BR,

CL,

BO

transactionId

string<uuid> | null

Transacción entrante vinculada cuando esté disponible

metadata

object

Metadatos opacos de la creación del checkout

completedAt

string<date-time> | null