Log into Sandbox

Switching Products with Different BINs

Suggest Edits

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.

ParameterDescription
CANCSUsed 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
CANOCWhen 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.

    1. Call Add Account with these parameters:
      • accountNo: <PRN or PAN of product 3333>
      • prodId: 4444
      • sharedBalance: 1
    2. Galileo returns the new PRN, PAN, expiry, and CVV,
    3. The emboss process creates a new emboss record in status: Y.
    4. When the new card is included in the batch file to send to the embosser, Galileo sends the SHIP: card_shipped event message.
    5. The embosser mails the new card to the cardholder.
    6. When the cardholder activates the card, you receive the BACT: card_activated event message.
    7. 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

    📘

    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 in status: C the cards cannot be used. See Closing accounts in the About Accounts guide for other ways to cancel an account, such as type: 16 (change both account and cards to status: Z) and type: 23 (change both account and cards to status: D). Make sure your chosen method does not cancel related accounts that you want to keep open, such as savings accounts.

    Updated 2 months ago