post https://sandbox-api.helix.q2.com/card/reissue
Reissue a card and send a new physical card to a customer (when applicable). Card must be in an eligible status listed below to perform a card renewal:
VerifiedReissued-DigitalActivePhysicalIntiatedDigitalActivePhysicalPending
Behavior by reissueReasonTypeCode:
DMG(Damage) – A new card number is not generated. If applicable, a new physical card is sent to the customer.REN(Renewal) – A new card number is not generated. The expiration date is updated, and if applicable, a new physical card is sent to the customer.- All other values – A new card number is generated.
Depending on the previous card type and the reason for reissue, this endpoint returns a card object with the following characteristics:
| Type | Reason | Card Number (PAN) | Card Object Status |
|---|---|---|---|
| Digital | Fraud, Lost, Stolen | New | status=Verified |
| Digital | Renewal | Same (new expiration date & CVV2) | status=Verified |
| Digital | Compromised, Name change | New | status=Verified |
| Digital w/ Physical | Physical damage | Same | status=Verified unless program requires verification; then status=DigitalActivePhysicalPending |
| Digital w/ Physical | Fraud, Lost, Stolen | New | status=DigitalActivePhysicalPending |
| Digital w/ Physical | Renewal | Same (new expiration) | status=ReissuePendingVerification |
| Digital w/ Physical | Compromised, Name change | New | Old cardId: Verified; new cardId: DigitalActivePhysicalPending. Once verified → new cardId: Verified, old cardId: Archived. |
| Physical | Physical damage | Same | status=Verified unless program requires verification; then status=PendingVerification |
| Physical | Fraud, Lost, Stolen | New | status=PendingVerification |
| Physical | Renewal | Same (new expiration date & CVV2) | status=ReissuePendingVerification |
| Physical | Compromised, Name change | New | Old cardId: Verified; new cardId: PendingVerification. Once verified → new cardId: Verified, old cardId: Archived. |
Error Codes
Click to expand
| Code | Message (en-US) | Notes |
|---|---|---|
| 1-60000 | Any "Common Error Code" may occur. | See Common Error Codes |
| Any error codes associated with card locking. | See /card/lock | |
| Any error codes associated with card initiation. | See /card/initiate | |
| Any error codes associated with card create digital. | See /card/createdigital | |
| 63502 | Requesting customer does not have 'FULL' access to account id ’42031914'. | |
| 150230 | Another card for CustomerId {request.customerId} is using NickName of {request.nickName}. NickName must be unique. | This error occurs when a new renewal newCardId exists and is in a status= ReissuedPendingVerification or AutoReissuedPendingVerification and a reissue is attempted due to a lost card but the oldCardID is still in a status=Verified. To resolve, hotlist the oldCardID via card/hotlist route and then reissue the newCardID as lost. |
| 150504 | CardId {request.cardId} has been locked by the System and cannot be unlocked by a customer. | |
| 153001 | Invalid reissueReasonTypeCode '{request.reissueReasonTypeCode}'. Please refer to API documentation for valid types. | |
| 153002 | CardId {request.cardId} is not associated with CustomerId {request.customerId}. | |
| 153003 | CardId {request.cardId} status is {card.status}. Must be Verified, Expired, or PendingVerification. | |
| 153004 | CardId {request.cardId} is digital-only. Cannot reissue a digital-only card. For digital-only cards use /card/hotlist then /card/createDigital to issue a new digital-only card. | |
| 153005 | Physical card order option not available for issuance type. | |
| 153006 | CardId '{request.cardId}' status is '{card.status}' and cannot be reissued. | |
| 153007 | Digital card reissue option not available for reissueReasonTypeCode '{request.reissueReasonTypeCode}'. | |
| 198120 | CardId {reissueReasonTypeCodecardId} status is {card.status} and cannot be renewed. | |
| 198121 | Card {request.cardld} cannot be renewed before the renewal period. | |
| 198122 | Card {request.cardId} cannot be used after the card expiration date. | |
| 198123 | Reissued cardId {request.cardid} already exists for cardId {request.cardid}. |