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
| Field | Type | Description |
|---|---|---|
| transactionStatus | Integer | Numeric status code (3 = Submitted/Success, 5 = Failed) |
| transactionStatusDescription | String | Human-readable status label (e.g., "Submitted", "Failed") |
| traceId | String | The unique identifier you assigned when initiating the withdrawal |
| transactionReference | String | System-generated unique reference for the transaction |
| money.amount | Decimal | Transfer amount |
| money.currency | String | Currency code (ISO 4217) |
| money.presentationAmount | String | Formatted display string (e.g., "EUR250.00") |
| source | String | Source account number (merchant) |
| destination | String | Destination account number (client) |
| eventTypeDescription | String | Type of transaction (e.g., "Account to Account Transfer") |
| paymentCategoryType | String | Category of the payment (e.g., "GAMING_PAYOUT") |
| errorMessage | String | Error details when the transaction fails; null on success |
| createdOn | DateTime | Timestamp of transaction creation (ISO 8601) |
Updated 10 days ago