Card Real Time Authorisation

This notification is triggered for real-time authorisation.

https://<customerHost:Port>/handlenotification

Header

Field	Description
Content-Type	application/json

Request example

curl --location --request POST 'https://<customerHost:Port>/notifications' \
-H 'Content-Type: application/json' \
-d '{
  "notificationType": "CARD_REAL_TIME_AUTH",
  "notificationCreationTime": "2025-05-16T12:37:51.066436Z",
  "notificationContent": {
    "realTimeAuthRef": 123456,
    "authCode": "XYZ987",
    "billingAmount": 12.75,
    "billingCurrency": "EUR",
    "cardReference": "CARD999",
    "ecbRate": "0.0123",
    "forexRate": "",
    "linkedBalanceReference": "BAL123",  
    "mccCode": "5912",
    "merchantId": "MID999",
    "merchantName": "Pharmacy",
    "originalAmount": 12.75,
    "originalCurrency": "EUR",
    "remainingSpendLimit": "1000.00",
    "terminalCode": "TERM01",
    "transactionTimestamp": "2025-05-16T11:59:00Z",
    "transactionReference": "TXN999888",
    "transactionType": "AUTHORISATION"
  }
}'

Request Body

Field	Description	Type
notificationType	Specifies the type of notification being sent.	string required
notificationCreationTime	Specifies the creation date and time for the notification. The date format conforms to ISO 8601	string required
notificationContent	Specifies the notification content	object required

Properties of notificationContent

Field	Description	Type
realTimeAuthRef	Represents a unique identifier for the real-time authorisation	string required
authCode	Contains the code with which the authorisation is labelled when approved	string required
billingAmount	It specifies the currency of the billing amount of the transaction in ISO 4217 format, which is also the currency of the virtual card.	string required
billingCurrency	Currency of the billing amount.	string required
cardReference	The unique identifier of the card.	string required
ecbRate	Reference exchange rate (for informational purposes).	string
forexRate	The exchange rate used between the source currency and destination currency (if they are different)	string
linkedBalanceReference	Represents a unique identifier for the Balance assosiated with this instrument.	string.
mccCode	Contains the merchant category code.	string required
merchantId	Contains the ID of the merchant where the purchase occurred.	string required
merchantName	Contains the name of the merchant where the purchase occurred.	string required
originalAmount	Represents the original amount of the transaction.	string required
originalCurrency	Specifies the currency of the original amount of the transaction in ISO 4217 format.	string required
remainingSpendLimit	The remaining amount available for spending on the card, expressed as a decimal value.	string required
terminalCode	Contains a code that identifies the terminal usually defined as the Terminal ID	string required
transactionTimestamp	Represents the date and time when the transaction was executed, in ISO 8601 format.	string required
transactionReference	Unique identifier for the transaction.	string required
transactionType	Type of transaction (e.g., AUTHORISATION)	string required