Notification callbacks for withdrawals


Upon finalizing the withdrawal transaction, we will perform an API callback to confirm the status of the transaction. Kindly use this callback as the final indication that the payment was performed successfully.

We will send the callbacks upon successful or failed transaction. Our callbacks are linked to the transaction status.

You can either provide us with different URLs such that the transaction success or transaction failure are separated, or you can provide us with one URL and handle the different cases from within your logic.

📘

Send your callback URLs (for both demo and production) so they can be whitelisted and configured on our end.

Callback structure

A successful withdrawal callback has transactionStatus: 3 and transactionStatusDescription: "Submitted".

{
  "postedOn": null,
  "money": {
    "amount": 250,
    "currency": "EUR",
    "presentationAmount": "EUR250.00"
  },
  "source": "5001000001212099",
  "destination": "5001000001219615",
  "description": "Test Acc-to-acc",
  "transactionStatus": 3,
  "transactionStatusDescription": "Submitted",
  "traceId": "traceid dfafhdjkfhdaskjfhnduaf",
  "transactionReference": "b814efb2-f07d-487a-a814-4cd5195bc66d",
  "eventTypeDescription": "Account to Account Transfer",
  "createdOn": "2023-10-11T15:21:25.335Z",
  "arn": null,
  "paymentCategoryType": "GAMING_PAYOUT",
  "externalReference": null,
  "sourceEmail": null,
  "merchantCompanyName": null,
  "additionalInfo": null,
  "errorMessage": null
}

Field reference

FieldTypeDescription
transactionStatusIntegerNumeric status code (3 = Submitted/Success, 5 = Failed)
transactionStatusDescriptionStringHuman-readable status label (e.g., "Submitted", "Failed")
traceIdStringThe unique identifier you assigned when initiating the withdrawal
transactionReferenceStringSystem-generated unique reference for the transaction
money.amountDecimalTransfer amount
money.currencyStringCurrency code (ISO 4217)
money.presentationAmountStringFormatted display string (e.g., "EUR250.00")
sourceStringSource account number (merchant)
destinationStringDestination account number (client)
eventTypeDescriptionStringType of transaction (e.g., "Account to Account Transfer")
paymentCategoryTypeStringCategory of the payment (e.g., "GAMING_PAYOUT")
errorMessageStringError details when the transaction fails; null on success
createdOnDateTimeTimestamp of transaction creation (ISO 8601)

What’s Next