Skip to main content

Card Purchase

This notification is triggered for card purchase transactions.

https://<customerHost:Port>/handlenotification
FieldDescription
Content-Typeapplication/json

Request example

curl --location --request POST 'https://<customerHost:Port>/notifications' \
-H 'Content-Type: application/json' \
-d '{
"notificationType": "CARD_PURCHASE",
"notificationCreationTime": "2025-05-16T12:37:51.066436Z",
"notificationContent": {
"cardReference": "CARD123",
"authCode": "ABC123",
"mccCode": "5812",
"merchantId": "MID456",
"merchantName": "Coffee Shop",
"originalAmount": 5.50,
"originalCurrency": "EUR",
"billingAmount": 5.50,
"billingCurrency": "EUR",
"transactionTimestamp": "2025-05-16T12:00:00Z",
"transactionReference": "TXN456789",
"transactionState": "APPROVED",
"transactionType": "PURCHASE"
}
}'

Request Body

FieldDescriptionType
notificationTypeSpecifies the type of notification being sent.string
required
notificationCreationTimeSpecifies the creation date and time for the notification. The date format conforms to ISO 8601string
required
notificationContentSpecifies the notification contentobject
required

Properties of notificationContent

FieldDescriptionType
authTransactionReferenceRepresents a unique identifier for the real-time authorisation.string
required
cardReferenceThe unique identifier of the card.string
required
cardTypeDefines the type of card to be created. (e.g., PREPAID, BALANCELESS).string
required
linkedBalanceReferenceRepresents a unique identifier for the Balance assosiated with this instrument.
mccCodeContains the merchant category code.string
required
merchantIdContains the ID of the merchant where the purchase occurred.string
required
merchantNameContains the name of the merchant where the purchase occurred.string
required
originalAmountRepresents the original amount of the transaction.string
required
originalCurrencySpecifies the currency of the original amount of the transaction in ISO 4217 format.string
required
billingAmountRepresents the billing amount of the transaction in the card currency.string
required
billingCurrencyIt specifies the currency of the billing amount of the transaction in ISO 4217 format, which is also the currency of the virtual card.
transactionTimestampRepresents the date and time when the transaction was executed, in ISO 8601 formatstring
required
transactionReferenceUnique identifier for the transaction.string
required
transactionTypeRepresents the type of purchase operation. (e.g., PURCHASE).string
required
authCode Contains the code with which the authorisation is labelled when approvedstring
required