Notification Callbacks
Whenever a transaction is successful (status SUBMITTED), rejected (status REJECTED) or processed by our acquirer (PROCESSED_BY_ACQUIRER), we can send an HTTP JSON notification callback to confirm the status of the transaction. Kindly use this callback as the final indication that the payment was performed successfully.
This means that for a successful transaction, you will receive 2 notifications. The first one is when the transaction is in status SUBMITTED (this is when the movement of funds happen). The second one is the confirmation which normally happens the next day during the reconciliation process.
You would need to specify to our integration team ([email protected]) the endpoint/s required, for both DEMO and PROD. The design of how you consume the callbacks is up to your development team. You can either have one endpoint and differentiate the success/fail response from within your internal logic, or you can specify a separate endpoint for each. Please ensure that the status 200 is returned (no response body needed).
The notification callback structure is the below :-
{
"postedOn": null,
"money": {
"amount": 10,
"currency": "EUR",
"presentationAmount": "EUR10.00"
},
"source": "5001000001212099",
"destination": "EE bank",
"description": "test EE success",
"transactionStatus": 3,
"transactionStatusDescription": "Submitted",
"traceId": "ce1035ae-ffc8-4ab4-8493-4ef7ef5b546e",
"transactionReference": "3f57cb79-0707-4249-924a-15780a3f930e",
"eventTypeDescription": "Pay Any Bank",
"createdOn": "2023-10-10T14:33:37.412Z",
"arn": null,
"paymentCategoryType": "GAMING_PAYOUT",
"externalReference": "P2100CVTHJ",
"sourceEmail": null,
"merchantCompanyName": "MiFinity",
"additionalInfo": null,
"errorMessage": null
}
{
"postedOn": null,
"money": {
"amount": 10,
"currency": "GBP",
"presentationAmount": "GBP10.00"
},
"source": "5001000001212099",
"destination": "XXXXX100",
"description": "test GB success",
"transactionStatus": 5,
"transactionStatusDescription": "Processed by acquirer",
"traceId": "21d1490b-0764-424e-8e31-1f2a17d72088",
"transactionReference": "82dcb6d9-6ada-4c20-9d77-168b6938995e",
"eventTypeDescription": "Pay Any Bank",
"createdOn": "2024-02-12T10:58:56.594Z",
"arn": null,
"paymentCategoryType": "GAMING_PAYOUT",
"externalReference": "3985217",
"sourceEmail": null,
"merchantCompanyName": "MiFinity",
"additionalInfo": null,
"errorMessage": null
}
Field | Type | Description |
---|---|---|
postedOn | String | Default value: null |
money | Object | Containing amount (Decimal), currency(String) and presentationAmount(String) |
source | String | Source Account Number |
destination | String | Destination Account Number |
transactionStatus | Integer | Transaction status |
description | String | Description for this transaction |
transactionStatusDescription | String | RECEIVED(1), INTERNAL_ERROR(2), SUBMITTED(3), PROCESSED_BY_ACQUIRER(5), REJECTED(6), IN_PROGRESS(7) and ON_HOLD_KYC(8) |
traceId | String | Trace id of original request |
transactionReference | String | Transaction reference |
eventTypeDescription | String | PayMyCard, PayAnyCard, PayAnyBank, Account to Account Transfer, Coupon Transfer |
createdOn | DataTime | Date Time for the transaction |
paymentCategoryType | String | Containing the category type |
Note: Please ignore any additional fields passed within this response.
Updated 9 months ago