added
Replace cards
March 21st, 2023
We are adding a new endpoint that allows replacing cards.
Replace cards
We are introducing a new endpoint POST /cards/{cardId}/replace that enables you to replace existing cards with new ones.
- When replacing cards all existing configurations will be set up automatically based on the values of the existing card (e.g.
limit
,transactionLimit
...) - The big advantage of replacing cards (in comparison to terminate and re-issue a new card) is that most subscriptions (that have been set up using the payment data of the replaced card) will still continue to work without updating the payment data. To put it differently: Most merchants (especially big ones) will still be able to deduct money using outdated payment details (PAN, CVV and expiry date). This effectively reduced the danger of failed payments until the payment details have been updated by the cardholder.
- The endpoint only works for cards with types
VIRTUAL
,PHYSICAL
orTRAVEL
- Allowed values for property
terminateCardReason
are depending on card type- For cards with type
PHYSICAL
all values are valid. IfLOST
,STOLEN
is provided, the replaced card gets automatically terminated; ifDAMAGED
orOTHER
is provided the replaced card gets terminated only once the newly created card is activated. - For cards with type
VIRTUAL
orTRAVEL
only the valuesSTOLEN
(for compromised card details) orOTHER
are allowed. In both cases, the replaced card gets immediately terminated.
- For cards with type
Minor improvements
- We have updated our API lifecycle guidelines