Sign in

v1

latestOpenAPI 3.0.02026-08-04620256.0 KB
Card
Swipe
Physical Card

Reissue Card

put/cards/{cardId}/replace

Path parameters

cardIdstring uuid required

The unique identifier of the card that requires re-issuance.

Headers

Accept-Versionstring required

Specifies the API version to use for this request.

Request body

renewOption'IDENTICAL_TO_THE_CURRENT_CARD' | 'CALCULATE_NEW_EXPIRY_DATE' | 'NEW_CARD_NUMBER_WITH_SAME_EXPIRY_DATE' | 'NEW_CARD_NUMBER_WITH_NEW_EXPIRY_DATE' | 'SAME_CARD_NUMBER_WITH_NEW_CUSTOM_EXPIRY' | 'NEW_CARD_NUMBER_WITH_NEW_CUSTOM_EXPIRY'

This field is optional. If left unfilled, it defaults to NEW_CARD_NUMBER_WITH_NEW_EXPIRY_DATE, which sets the expiry date to three years from the current month.

Available Options: IDENTICAL_TO_THE_CURRENT_CARD, CALCULATE_NEW_EXPIRY_DATE, NEW_CARD_NUMBER_WITH_SAME_EXPIRY_DATE, NEW_CARD_NUMBER_WITH_NEW_EXPIRY_DATE, SAME_CARD_NUMBER_WITH_NEW_CUSTOM_EXPIRY, NEW_CARD_NUMBER_WITH_NEW_CUSTOM_EXPIRY. For specific use cases of each option, see the Renew option use cases table above.

expiryDatestring date

Card expiry date, in format of YYYY-MM-DD. It needs to be at least 1 month from the date of creation.

Example request

{
  "expiryDate": "2025-08-08",
  "shippingInformation": {
    "shippingAddress": {
      "country": "HK"
    }
  }
}

Response

Successfully reissued card