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",
    "mccCode": "5912",
    "merchantId": "MID999",
    "merchantName": "Pharmacy",
    "originalAmount": 12.75,
    "originalCurrency": "EUR",
    "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
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
cardType	Defines the type of card to be created. (e.g., PREPAID, BALANCELESS).	string required
ecbRate	Reference exchange rate (for informational purposes).	string
forexFeeAmount	Represents the amount of the Forex fee.	string
forexCurrency	Represents the currency of the Forex fee.	string
linkedBalanceReference	Represents a unique identifier for the Balance assosiated with this instrument.	string required
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	string
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