Switching Products with Different BINs
This guide explains how to switch card products when the old and new products have the same program ID but different BINs.
If the old and new card products have the same BIN, see Using the Switch Product endpoint in the Switching Products guide for instructions.
Result of following this procedure
When this procedure is completed successfully, a new card account with the new product ID is created, and it shares a balance with the old card account. The new card has a new PAN, CAD, expiry, and CVV. The new card and account are active and the old card and account are canceled.
Program parameters
These program parameters are related to card-activation behavior.
Parameter | Description |
---|---|
CANCS | Used in conjunction with CANOC, it specifies the status that a card must be in to be canceled when a new card is activated. Default: N,X,Y,W |
CANOC | When this parameter is set and the new card (new PAN) is activated, other cards in the statuses specified in CANCS and belonging to the same cardholder are canceled (status: C ):Y — Cancel all cards regardless of prod_id .Prod — Cancel only the cards with the same prod_id .When this parameter is not set, other active cards are not canceled. |
Procedure
This procedure shows how to switch from product ID 3333 to product ID 4444. For details on using the Add Account endpoint, see the Adding an Account guide.
- Call Add Account with these parameters:
accountNo:
<PRN or PAN of product 3333>prodId: 4444
sharedBalance: 1
- Galileo returns the new PRN, PAN, expiry, and CVV,
- The emboss process creates a new emboss record in
status: Y
. - When the new card is included in the batch file to send to the embosser, Galileo sends the
SHIP: card_shipped
event message. - The embosser mails the new card to the cardholder.
- When the cardholder activates the card, you receive the
BACT: card_activated
event message. - During the activation process, Galileo checks CANOC at the program level:
- If CANOC is
Y
, the old card is canceled. - If CANOC is not set, the old card and account are still active. Call Modify Status with these parameters:
accountNo:
<PRN or PAN of product 3333>type: 2
- If CANOC is
Note
Modify Status with
type: 2
cancels the old account but does not change the status of the cards associated with the account; however, with the account instatus: C
the cards cannot be used. See Closing accounts in the About Accounts guide for other ways to cancel an account, such astype: 16
(change both account and cards tostatus: Z
) andtype: 23
(change both account and cards tostatus: D
). Make sure your chosen method does not cancel related accounts that you want to keep open, such as savings accounts.
Updated 9 months ago