Build payments into your product with TPE virtual. Start integrating →
Logo

Webhook events

The delivery format and the events you can subscribe to.

Delivery format

Each delivery is a JSON POST to your endpoint, signed with an X-Mytpe-Signature header.

{
  "id": "e3b0c442-98fc-4c14-9afb-f4c8996fb924",
  "event": "transaction.paid",
  "created": 1733745296,
  "api_version": "2026-05-16",
  "data": { "object": {} }
}
FieldTypeDescription
idstringThe event's ID. It's the same on every attempt, so use it to skip duplicates.
eventstringThe event type.
createdintegerWhen the event happened, as a Unix timestamp.
api_versionstringThe format of the payload.
data.objectobjectThe resource the event is about. Its fields depend on the event.

Ignore fields you don't recognize. A payload never includes card numbers or raw gateway data.

For the list of events, see Statuses and enums. To verify a signature, see Receive webhooks.

On this page