Fast-payout icon

Webhook structure and types

Learn which webhook types are sent for each event.

On this page, you'll find information about:

You'll also learn about which webhook types are sent based on which event.

Webhook structure

In general, the body of a webhook contains the following objects.

Parameter Data type Description
data Object Object that contains information about the event.
environment String The environment where the transaction was processed—test or live.
type String The webhook type.

The information contained in the data object varies and depends on the webhook type. You can find the full schema for each type in API Explorer.

Below is an example request body for a webhook of type balancePlatform.accountHolder.created.

Webhook types

Webhooks are typically sent when:

  • A resource was created or updated.
  • A request was initiated (such as a payment authorisation request, a refund request, or a funds transfer request).
  • There was a funds movement (funds added to or deducted from balance accounts).

You can differentiate the events based on the type. Some webhook types also include a data.status field that informs you of the outcome of the event.

Configuration webhooks

Configuration webhooks inform your system about events that occur with account holders, balance accounts, and payment instruments.

Type Description
balancePlatform.accountHolder.created An account holder was successfully created.
balancePlatform.accountHolder.updated An account holder was successfully updated.
balancePlatform.balanceAccount.created A balance account was successfully created.
balancePlatform.balanceAccount.updated A balance account was successfully updated.
balancePlatform.balanceAccountSweep.created A balance account sweep was successfully created.
balancePlatform.balanceAccountSweep.deleted A balance account sweep was successfully deleted.
balancePlatform.balanceAccountSweep.updated A balance account sweep was successfully updated.

Transfer webhooks

Transfer webhooks inform your system about incoming and outgoing transfers in your platform.

Type Description
balancePlatform.transfer.created A transfer request was created to credit funds to or deduct funds from a balance account in your platform. The content informs you of the event that triggered the transfer request, such as a payment or refund.
balancePlatform.transfer.updated A transfer request's status changed.

You can identify transfer webhooks sent for different events by checking the following parameters and values:

category type counterparty
Internal transfer internal internalTransfer balanceAccountId
Third-party payout bank bankTransfer bankAccount

Next steps

Learn which webhooks are sent for different scenarios.