Reissues a card and, when applicable, sends a new physical card to the customer.
Use this endpoint when a card needs to be replaced because it was damaged, lost, stolen, compromised, affected by fraud, or when an immediate renewal is needed. Some reissue reasons keep the same card number, while other reasons create a new card number.
If card-maintenance fees apply, the response includes the applied fees on the returned card object. If no fees apply, no fee items are returned.
Reissue reasons
| Reissue Reason Type Code | Meaning | Card number behavior |
|---|---|---|
DMG | Physical damage | Keeps the same card number. If applicable, a replacement physical card is sent. |
REN | Renewal | Keeps the same card number, updates the expiration date and CVV2, and sends a replacement physical card when applicable. |
FRD | Fraud | Creates a new card number. |
LST | Lost | Creates a new card number. |
STL | Stolen | Creates a new card number. |
NCN | Name change with new PAN | Creates a new card number. |
CMP | Compromised | Creates a new card number. |
Eligibility
Eligibility depends on the reissue reason and card type.
For REN, the card must be in one of these statuses:
VerifiedReissuedDigitalActivePhysicalInitiatedDigitalActivePhysicalPending
The renewal request must also be within the renewal window: from two months before the card expiration month through the card expiration date.
For DMG, Helix keeps the same card number. Digital-only cards cannot be reissued with the same card number, so DMG is not supported for digital-only cards.
For FRD, LST, STL, NCN, and CMP, Helix creates a new card number. These reasons can be used for physical, digital, and dual-issuance cards when the card is in an eligible reissue status. If a card status is not eligible, the response returns one of the card-status error codes listed below.
Resulting card object
| Previous card type | Reason | Card number | Resulting card status |
|---|---|---|---|
| Digital | Fraud, lost, stolen | New | Verified |
| Digital | Renewal | Same, with new expiration date and CVV2 | Verified |
| Digital | Compromised, name change | New | Verified |
| Digital with physical | Physical damage | Same | Verified, unless the program requires verification for reissues; then DigitalActivePhysicalPending |
| Digital with physical | Fraud, lost, stolen | New | DigitalActivePhysicalPending |
| Digital with physical | Renewal | Same, with new expiration | ReissuedPendingVerification |
| Digital with physical | Compromised, name change | New | Old card remains Verified; new card is DigitalActivePhysicalPending. After verification, the new card becomes Verified and the old card becomes Archived. |
| Physical | Physical damage | Same | Verified, unless the program requires verification for reissues; then PendingVerification |
| Physical | Fraud, lost, stolen | New | PendingVerification |
| Physical | Renewal | Same, with new expiration date and CVV2 | ReissuedPendingVerification |
| Physical | Compromised, name change | New | Old card remains Verified; new card is PendingVerification. After verification, the new card becomes Verified and the old card becomes Archived. |
Error Codes
Click to expand
The reissue flow can also surface errors from related card flows it calls internally, including card lock, card initiation, card digital creation, fee computation, and renewal. When that happens, Helix returns the same standard error envelope with the related error code and message.
| Code | Message (en-US) |
|---|---|
| 1-60000 | Any common Helix error code may occur. See Common Error Codes. |
| 61400 | Program not authorized to expedite card orders. Please contact your relationship manager for details. |
| 63502 | Requesting customer does not have FULL access to account id {accountId}. |
| 150230 | Another card for CustomerId {customerId} is using NickName of {nickName}. NickName must be unique. |
| 150254 | Invalid PhotoImageId. |
| 150255 | Invalid CardDesignIdentificationNumber. |
| 150256 | Invalid CardCarrierMessage. |
| 150257 | Invalid CardVendorUniqueData. |
| 150259 | Digital card reissue option not available for reissueReasonTypeCode {reissueReasonTypeCode}. |
| 150504 | CardId {cardId} has been locked by the System and cannot be unlocked by a customer. |
| 153001 | Invalid reissueReasonTypeCode {reissueReasonTypeCode}. Please refer to API documentation for valid types. |
| 153002 | CardId {cardId} is not associated with CustomerId {customerId}. |
| 153003 | CardId {cardId} status is {cardStatus} and cannot be reissued. |
| 153004 | CardId {cardId} is digital-only. Cannot reissue a digital-only card. |
| 153005 | Physical card order option not available for issuance type. |
| 153006 | CardId {cardId} status is {cardStatus} and cannot be reissued. |
| 153007 | Digital card reissue option not available for reissueReasonTypeCode {reissueReasonTypeCode}. |
| 158703 | Dual Issuance Single Pan Program setting is not enabled. |
| 198120 | CardId {cardId} status is {cardStatus} and cannot be renewed. |
| 198121 | Card {cardId} cannot be renewed before the renewal period. |
| 198122 | Card {cardId} cannot be used after the card expiration date. |
| 198123 | Reissued cardId {reissuedCardId} already exists for cardId {cardId}. |
| 201515 | Insufficient funds to cover card replacement fee. |