Update Travel Card Validity Period

Update the validity period of a travel card. This validity period is set during card issuing. Only available for cards with a cardConfig containing TRAVEL.

Path Params
uuid
required

The ID of the card to update. Has to be a travel card with a cardConfig containing TRAVEL.

Body Params
date
required

Field to describe a fixed date range in which the card is usable for purchases. Outside of this date range, the card cannot be used for any purchases, only for zero-amount card-checks, and is shown with status PENDING. Date needs to be provided as yyyy-mm-dd and is treated inclusive, meaning the provided date is already a valid day to use the card. The earliest possible date is the current date. The validFrom date needs to be before the validTo date. The fields validFrom, validTo and validTimezone need to be used together. This feature is only available for cards with a cardConfig containing TRAVEL or TRAVEL_CC, marking them as travel cards.

date
required

Field to describe a fixed date range in which the card is usable for purchases, replaces the validityPeriod if used. After the specified date, the card is automatically terminated. If not provided, the card is active until the validityPeriod ends. Date needs to be provided as yyyy-mm-dd and is treated inclusive, meaning the card will be terminated one day after this date. If used, the parallel usage of card controls regarding dates and/or times is not allowed and the validityPeriod will be set to 36 months automatically. The latest possible date is the end date of the validityPeriod. The fields validFrom, validTo and validTimezone need to be used together. This feature is only available for cards with a cardConfig containing TRAVEL or TRAVEL_CC, marking them as travel cards.

string
required

Field to describe the timezone for the validFrom and validTo fields. A list of valid timezones can be found in our guide section.

Responses
204

Ok. Card validity period was updated successfully.

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Choose an example:
application/json