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,PHYSICALorTRAVEL - Allowed values for property
terminateCardReasonare depending on card type- For cards with type
PHYSICALall values are valid. IfLOST,STOLENis provided, the replaced card gets automatically terminated; ifDAMAGEDorOTHERis provided the replaced card gets terminated only once the newly created card is activated. - For cards with type
VIRTUALorTRAVELonly the valuesSTOLEN(for compromised card details) orOTHERare allowed. In both cases, the replaced card gets immediately terminated.
- For cards with type
Minor improvements
- We have updated our API lifecycle guidelines
