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.

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

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