Switch Product

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.

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 prodId pass the new product ID.

Galileo recommends that you use this endpoint instead of Set Account Feature with type: 3 to switch products. For instructions see the Switching Products guide.

📘

Note

The expiry_date and card_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 codeDescription
590-01Product cannot be switched to the same product. Verify that prodId is different from the account's current product ID.
590-02Product cannot be switched to an unauthorized product. Verify that prodId is a valid product ID.
590-03Product 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-04Trying 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-05Product 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-06Product 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-07Product 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-08Product 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-09Product has been successfully switched but card reissue failed: Insufficient funds to cover reissue fee. Follow your business process for this use case.
590-10Product has been successfully switched but card reissue failed: Failure, generic error processing reissue fee. Contact Galileo for troubleshooting.
590-11If new_pan='Y' then new_expiry_date needs to be 'Y' too. Product did not switch. Verify that newExpiryDate: Y when newPan: Y.
590-12Product 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-13Product has been successfully switched but card reissue failed: Card reissue cannot be processed. Contact Galileo for troubleshooting.
Language
Click Try It! to start a request and see the response here!