v1

latestOpenAPI 3.0.32026-07-2621102.1 MB
Accounts and Cards

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.

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 <a href="ref:post_setaccountfeature" target="_blank">Set Account Feature</a> with type: 3 to switch products.

SoFi Tech Solutions recommends that you use the <glossary:CAD> for accountNo; however, you can use the <glossary:PRN> if only one card has ever been associated with the account.

For instructions on using this endpoint, see the <a href="doc:switching-products" target="_blank">Switching Products</a> 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 <a href="ref:post_getcard" target="_blank">Get Card</a> to retrieve the new values <a href="doc:switching-products#after-the-endpoint-response" target="_blank">after the emboss process has run</a>.

post/switchProduct

Response

status_codeinteger nullable required

The response status code. May return a string for some statuses.

statusstring nullable required

The condition of a process or response

processing_timenumber float nullable required

The time elapsed in processing the transaction

system_timestampstring date-time nullable required

A system generated timestamp

rtokenstring nullable required

A system-generated ID used for tracking

errorsstring[]

A list of errors generated while the request was processed