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>
Copyright © 2024 Trade-Safe Holdings (Pty) Ltd. All Rights Reserved.