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"