Cards
Card lifecycle
Integrated status and states
5 min
cross river defines several card statuses within cos that play a key role in how transactions are processed these statuses help govern the card’s lifecycle and support important compliance and security policies each status directly impacts whether a transaction is approved and what message is sent back to the card network during a transaction attempt cos uses this status system to make sure cards are managed securely and accurately card status also helps determine the overall card state cos assigns both statuses and states to cards to govern their behavior during authorization state changes are communicated via webhook events (such as cards status changed) to keep partner systems in sync card status the status refers to the card’s activation level and whether the cardholder is allowed to use it the card status also contributes to the integrated status and states docid\ t8ypzopbrvd8z8 prjiog the status attribute is the activation status of the card and if the card can be used by the cardholder unactivated the card has not been activated by the cardholder active the card is active and ready for use suspended the card is currently suspended closed the card is closed the orderstatus attribute is the current status of the order order pending the order is pending fulfillment by the processor completed the order has been fulfilled by the processor for physical cards, the card is being printed and mailed to the cardholder failed the order failed at the processor level the status of a newly created card is unactivated and the order status is orderpending the order status updates to completed when the order is complete for physical cards, this means the card has been mailed to the customer managing a card program may require you to update card statuses for specific scenarios for example, you may want to offer your customers added security by allowing them to temporarily suspend a card that has been misplaced update activated card status when necessary to suspend, block, or close a card suspended suspending a card temporarily inactivates it until you remove the suspension by activating the card again the cardholder is allowed to remove this block placed on administrative block an administrative block means that the card is both suspended and has been blocked using the admin block endpoint only an admin can remove this block closed important once the card is closed, it cannot be reactivated card states a given card status can be due to more than one reason for example, a card might be suspended because it was lost, stolen, or blocked due to fraud knowing the reason for a given status is important to manage the card life cycle at cross river we call combination of status and other attributes card state you see the card state in the cards status changed webhook event you need to banking and payments to receive webhooks card state card status other related fields and their values card has never been activated unactivated card activated active card closed closed card lost suspended statusreasoncode = lost card stolen suspended statusreasoncode = stolen admin blocked suspended adminblocked = true fraud blocked suspended fraudsuspect = true statusreasoncode = fraudblocked card suspended by user suspended statusreasoncode = notset card unsuspended by user or admin active statusreasoncode = notset fraudsuspect = false adminblocked = false