Skip to content


Each time the state changes on a transaction the API will send a callback to the URL provided in your application settings.

The callback provides several details:

  • The states for the transaction, allocation and drawdowns (If used)
  • The last updated date
  • The ID of the transaction, allocations and drawdowns (If used)


This is a typical example of a callback you would get after the buyer has made a deposit.

"url": "",
"data": {
"id": "4apICtLE2JPu1NfoWURmL",
"reference": "TKYB6PZ3",
"state": "FUNDS_RECEIVED",
"balance": "0.0000",
"updated_at": "2021-06-14 09:25:03",
"allocations": [
"id": "4RwHQ1bQsmA5v4tjf5o0m6",
"state": "CREATED",
"updated_at": "2021-06-14 09:24:08"



To help prevent unknown third parties from sending callbacks to your endpoint you can whitelist the following IP addresses.

Sandbox / Development
Live / Production

Webhook Secret

Alternatively you can use a unique key or identifier when setting up the callback url for your application. This can be included inline or as a query parameter.

Inline Secret<webhook-secret-key>

Query parameter<webhook-secret-key>