Use the Switch Product endpoint to change the product ID on the specified account to a new product ID. To control whether the product switch triggers a card reissue, set doReissue.
For prodId pass the new product ID. This endpoint is valid only for card-account products. For products that do not have a card, use Set Account Feature with type: 3 to switch products.
Galileo recommends that you use the CAD for accountNo; however, you can use the PRN if only one card has ever been associated with the account.
For instructions on using this endpoint, see the Switching Products guide.
Note
The
expiry_dateandcard_security_code(CVV2) that are returned by the endpoint are not the new values. The new values are generated later by the emboss process. Call Get Card to retrieve the new values after the emboss process has run.
Status codes
See Global Response Statuses for status codes that are common across endpoints.
| Status code | Description |
|---|---|
| 590-01 | Product cannot be switched to the same product. Verify that prodId is different from the account's current product ID. |
| 590-02 | Product cannot be switched to an unauthorized product. Verify that prodId is a valid product ID. |
| 590-03 | Product has been successfully switched but card reissue failed: The valid values for newPanFlag and newExpirationDate include Y/N. Call Reissue Card to complete the reissue, and verify that newPanFlag and newExpiryDate are set to Y, N or blank |
| 590-04 | Trying to update card status without requesting new PAN. The product has not been successfully switched and card reissue failed. If newPan is N or blank then oldCardStatus must be blank. |
| 590-05 | Product has been successfully switched but card reissue failed: The valid values for oldCardStatus include D/C. Call Reissue Card to complete the reissue and verify that oldCardStatus is set to C, D or blank. |
| 590-06 | Product has been successfully switched but card reissue failed: Trying to update card status without requesting new PAN. Call Reissue Card to complete the reissue. If newPan is N or blank then oldCardStatus must be blank. |
| 590-07 | Product has been successfully switched but card reissue failed: Failure getting data associated with account/card. Cannot retrieve CAD, ENP or product ID. Call Reissue Card to complete the reissue or contact Galileo for troubleshooting. |
| 590-08 | Product has been successfully switched but card reissue failed: Failure getting data associated with account/card. CAD or XID is null. Contact Galileo for troubleshooting. |
| 590-09 | Product has been successfully switched but card reissue failed: Insufficient funds to cover reissue fee. Follow your business process for this use case. |
| 590-10 | Product has been successfully switched but card reissue failed: Failure, generic error processing reissue fee. Contact Galileo for troubleshooting. |
| 590-11 | If new_pan='Y' then new_expiry_date needs to be 'Y' too. Product did not switch. Verify that newExpiryDate: Y when newPan: Y. |
| 590-12 | Product has been successfully switched but card reissue failed: card has pending reissue records. There is an emboss record in status: Y with the same product ID as the new product ID. This is a common status during testing when switching the same account repeatedly between products. If the existing emboss record is the desired emboss record, take no action. That card will be sent to the cardholder. If you are testing, call Activate Card to activate the existing emboss record and then call Reissue Card to complete the reissue. |
| 590-13 | Product has been successfully switched but card reissue failed: Card reissue cannot be processed. Contact Galileo for troubleshooting. |