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:
Verified
Reissued
DigitalActivePhysicalIntiated
DigitalActivePhysicalPending
If reissueReasonTypeCode=DMG
, a new card number is not generated and, if applicable, a new physical card is sent to the customer. If reissueReasonTypeCode=REN
, 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 reissueReasonTypeCode
values will generate a new card number.
Depending on the previous card and reason for reissue, this endpoint will return a card object with the following:
Type | Reason | Card Number (PAN) | Card Object Status |
---|---|---|---|
Digital | Fraud, Lost, Stolen | New | status=Verified |
Digital | Renewal | Same, with new expiration date and CVV2 | status=Verified |
Digital | Compromised, Name change | New | status=Verified |
Digital w/ physical | Physical damage | Same | status=Verified unless program requires verification for reissues then status=DigitalActivePhysicalPending |
Digital w/ physical | Fraud, Lost, Stolen | New | status=DigitalActivePhysicalPending |
Digital w/ physical | Renewal | Same, with new expiration | status=ReissuePendingVerification |
Digital w/ physical | Compromised, Name change | New | Old cardId status=Verified new cardId status=DigitalActivePhysicalPending . Once verified, new cardId status=Verified and old cardId status=Archived |
Physical | Physical Damage | Same | status=Verified unless program requires verification for reissues then status=PendingVerification |
Physical | Fraud, Lost, Stolen | New | status=PendingVerification |
Physical | Renewal | Same, with new expiration date and CVV2 | status=ReissuePendingVerification |
Physical | Compromised, Name change | New | Old cardId status=Verified new cardId status=PendingVerification . Once verified, new cardId status=Verified and old cardId status=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}. |