Card Statuses

A card's status is designated by a single capital letter in the Galileo system, as shown in the Card Statuses enumeration.

📘

Note

Card status is not the same as account status. The statuses may be similar in some cases, but they operate independently. Compare with the Account Statuses enumeration.

When a merchant attempts to authorize a transaction, the Galileo system checks to see whether the card is active (status: N). The account must also be active (status: N) for the transaction to be approved. When a card or account is not active the authorization request is denied.

In both the Card Statuses and Account Statuses enumerations, the columns on the right show which operations are permitted for each status. Keep in mind that the Galileo system always checks both the card and account statuses when determining whether to allow a transaction.

Changing card statuses

The original status of a card is determined by the XAACT parameter. This parameter has three characters—the third character specifies which status to assign to new cards. Default is W (waiting to be processed). For virtual and Digital First cards the value is N (normal, active), because they are activated at the time they are created.

Card statuses can be changed either manually with an endpoint or automatically by internal Galileo processes. To manually change a card status, use the Modify Status endpoint. Make sure the type affects what you want it to affect—some types affect both the card and the account, whereas others affect only the account or only the card.

Automated processes that change a card status include:

  • Emboss process — Picks up cards in status: X (set to emboss) or status W, includes them in the batch file for the emboss vendor, and changes the cards to status: Y (ready to activate).
  • Card activation — When the cardholder activates the card using your designated methods, the card is changed to status: N (normal, active). Depending on your settings, other cards on the account may be set to status: C (canceled) at the same time. See Activating a Card for more information.
  • Lost/stolen — When you use Modify Status to report a lost or stolen card, the process changes the card to status: L or status: S. See Lost, Stolen, or Damaged Cards for more information.
  • PIN failures — When the number of failed PIN attempts reaches a threshold, the card may be changed to status: B, depending on your settings.
  • Card reissue or replacement — When a reissued or replacement card is activated, the previous card may be set to status: C or status D, depending on the parameters you pass with the Reissue Card endpoint call. See Reissuing Cards for more information.
  • Fraud detection — If you are using Galileo's fraud-detection engine, you can configure a rule to set a card to a disabled status when certain criteria are true.

Freezing cards

Instead of reporting a card as lost or stolen, your cardholders might want to temporarily freeze a card. A frozen card cannot be used for purchases but has not been canceled. An account with a frozen card can still receive payments and deposits. As soon as the card is unfrozen it is usable again without reissuing the card or creating a new card. Reasons for freezing a card rather than disabling or canceling it include:

  • The cardholder cannot locate their card but is not ready to report it lost or stolen.
  • Parents want to stop their teenager from accessing funds for a time.
  • A company wants to temporarily withdraw fund access for an employee.

To freeze a card call the Modify Status endpoint with type: 17. To unfreeze it use type: 18.

When you call Modify Status with type: 17 to freeze a card, and you do not pass startDate and endDate, the card is frozen for 24 hours starting with the current date-time. When unfreezing a card with type: 18, the startDate and endDate parameters are ignored and the card is unfrozen immediately.

📘

Note

Modify Status types 17 and 18 do not change the card or account status. To see whether a card is frozen call the Get Card or Get Account Cards endpoint and check the freeze_info object.

Events API messages

These event messages indicate stages in the card lifecycle and changes to card status. You must arrange with Galileo to receive these event messages:

  • SHIP: card_shipped — The card has been picked up by the emboss process and is included in the batch file for the embosser. Card is now in status: Y.
  • BACT: card_activated — Card has been activated and is now in status: N.
  • CSNT: card_status_change — The card status has changed to a status specified in the CDMSG parameter. This event message is triggered regardless of which process changed the status.
  • FRZN: frozen — The card has been frozen. The status has not changed.
  • UFRZ: unfrozen — The card has been unfrozen. The status has not changed.
  • CDFR: bulk_frozen — The card has been frozen by a bulk-freeze action in the CST.
  • RBEX: card_expiring — The card will expire in the number of configured days. Default: 30 days.
  • PSUC: card_returned — The cardholder mailed the card back and the shipping room recorded the return.
  • LSCN:lost/stolen card no replacement — The card has been marked lost or stolen and no replacement card has been created. Status is L or S.
  • LSCR:lost/stolen card with replacement — The card has been marked lost or stolen and a replacement card has been created. Status is L or S.

Did this page help you?