Webhook Schema

The webhook schema defines the structure of payloads sent by TransFi to notify your system about important events in real time.

These notifications are sent in real-time as JSON objects and are triggered at both the user and order levels.

Webhooks ensure your system stays updated with the latest status changes, providing all necessary details for seamless event processing.

Webhook Payload Structure

Each webhook payload contains the following top-level fields:

FieldTypeDescription
entityTypeStringType of entity associated with the event. Possible values: user, order
entityIdStringUnique identifier of the entity (userId or orderId)
statusStringCurrent status of the entity at the time the event was triggered
userObjectUser-related information associated with the event
orderObjectOrder-related information associated with the event