Card Expiry Alert

This webhook event is triggered when a card is approaching its expiration date. This event is triggered on the following schedule:

45 days before the card expires
30 days before the card expires
15 days before the card expires

Endpoint

POST https://<customerHost:Port>/webhook

Headers

Field	Description
`Content-Type`	Specifies the media type of the resource; here, `application/json`.
`x-request-id`	A unique identifier for the request. Example: `123e4567-e89b-12d3-a456-426655440000`.

cURL Request Example

curl --location --request POST 'https://<customerHost:Port>/webhook' \
--header 'Content-Type: application/json' \
--header 'x-request-id: 123e4567-e89b-12d3-a456-426655440000' \
--data-raw '{
    "firstName": "John Doe",
    "cardNumber": "4611-35XX-XXXX-1234",
    "clientHashId": "d4e1e512-hhd7-4eca-ad41-dd39325facc2",
    "cardHashId": "0de1e512-e0d7-4eca-ad41-dd39325facc2",
    "expiryDay": "45",
    "customerHashId": "0de1e512-e0d7-4eca-ad41-dd39325facc2",
    "walletHashId": "0de1e512-e0d7-4eca-ad41-dd39325facc2",
    "template": "CARD_EXPIRY_CARD_WEBHOOK"
}'

Request Body Details

Field	Description	Type
`firstName`	First name of the card owner.	String
`cardNumber`	The 16-digit masked card number, in the format `4611-35XX-XXXX-1234`.	String
`clientHashId`	Unique client identifier generated and shared upon client creation.	UUID
`cardHashId`	Unique card identifier created during new or add-on card issuance.	UUID
`expiryDay`	Number of days remaining until the card expires.	String
`customerHashId`	Unique customer identifier generated and shared at the time of customer creation.	UUID
`walletHashId`	Unique wallet identifier generated simultaneously with customer creation.	UUID
`template`	The value for the Card Expiry Alert event is `CARD_EXPIRY_CARD_WEBHOOK`.	String