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
}
FieldTypeDescription
postedOnStringDefault value: null
moneyObjectContaining amount (Decimal), currency(String) and presentationAmount(String)
sourceStringSource Account Number
destinationStringDestination Account Number
transactionStatusIntegerTransaction status
descriptionStringDescription for this transaction
transactionStatusDescriptionStringRECEIVED(1), INTERNAL_ERROR(2), SUBMITTED(3), PROCESSED_BY_ACQUIRER(5), REJECTED(6), IN_PROGRESS(7) and ON_HOLD_KYC(8)
traceIdStringTrace id of original request
transactionReferenceStringTransaction reference
eventTypeDescriptionStringPayMyCard, PayAnyCard, PayAnyBank, Account to Account Transfer, Coupon Transfer
createdOnDataTimeDate Time for the transaction
paymentCategoryTypeStringContaining the category type

📘

Note: Please ignore any additional fields passed within this response.