improved
Cardholder status & card limit change callback
January 18th, 2023
We added some minor improvements in the domains of cardholder and card limit endpoints
Cardholder status
Previously the cardholder status was not exposed. We improved it by:
- adding the
status
property to query params & response body of GET /api/cardholders - adding the
status
property to the response body of GET /api/cardholders/{cardholderId} - adding a new callback
CARDHOLDER_INVITED
to POST /cardholders/subscription which is triggered when a member is invited. - extending the Callback object
cardholderUpdate
withstatus
property
Possible ENUMs are:
INVITED
ACTIVE
DEACTIVATED
Card limit changes
We do now provide more granular information about card limit changes. So whenever one of the listed properties of a card is updated we trigger the CARD_LIMIT_CHANGED
callback (if setup via POST /cards/subscriptions).
transactionLimit
monthlyLimit (this one is deprecated)
limit
limitRenewFrequency
We provide a new property called limitChange which includes the previous and the new values so you can easily build e.g. notifications on top of it. Please find an example below:
{
"eventType": "CARD_LIMIT_CHANGED",
"cardId": "...",
"organizationId": "...",
"cardholderId": "...",
"type": "VIRTUAL",
"status": "ACTIVE",
"label": "Test",
"limitChange": {
"beforeChange": {
"transactionLimit": {
"value": 4200,
"currency": "EUR"
},
"limit": {
"value": 4200,
"currency": "EUR"
},
"limitRenewFrequency": "QUARTERLY"
},
"afterChange": {
"transactionLimit": {
"value": 8400,
"currency": "EUR"
},
"limit": {
"value": 8400,
"currency": "EUR"
},
"limitRenewFrequency": "QUARTERLY"
}
}