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

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

Changes

No recorded changes to this endpoint across all 1 revision of this API.