Events

Webhook Event Structure

All webhook notifications sent by our platform follow the same base structure. The only part that changes between event types is the content of the data object, which contains the payload specific to each event (e.g., charge, transaction, payment-link, etc.).

Below is the standard structure used for every webhook:

{
    "metadata": null,
    "id": "evt_01mpxru3t9qyl507hazjqdk8nb", // event identifier
    "type": "payment-link.pending", // notification type
    "data": {}, // transaction type object
    "createdAt": "2025-12-02T12:59:02.980Z" // notification date
}
  • id: Unique ID of the event.

  • type: Event type, indicating what triggered the webhook (e.g. charge.pending, transaction.pending).

  • data: Object containing the detailed event payload, this is the only part that changes between event types.

  • metadata: Optional, user-defined metadata.

  • createdAt: Timestamp when the event was generated.