Card Purchase
This notification is triggered for card purchase transactions.
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_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
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 |
---|---|---|
authTransactionReference | Represents a unique identifier for the real-time authorisation. | 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 |
linkedBalanceReference | Represents a unique identifier for the Balance assosiated with this instrument. | |
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 |
billingAmount | Represents the billing amount of the transaction in the card currency. | string required |
billingCurrency | It specifies the currency of the billing amount of the transaction in ISO 4217 format, which is also the currency of the virtual card. | |
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 | Represents the type of purchase operation. (e.g., PURCHASE). | string required |
authCode | Contains the code with which the authorisation is labelled when approved | string required |