Integrated card actions
Card actions
COS supports full card lifecycle management, enabling partners to control card operations via:
- COS APIs (direct system-to-system integration)
- COS Explorer (Cross River’s operational UI)
Key lifecycle events include:
- Card creation: Physical or virtual.
- Card activation: Transition from Unactivated to Active.
- Set card PIN: Set intial PIN for the card.
- Replacement or re-issue: For lost, stolen, or expired cards
- Suspension and unsuspension: Temporary blocks
- Card closure: Permanent deactivation
Once a card is closed, it cannot be reactivated. A new card must be issued if card access is needed again.
Card creation
For card creation using our create a new card API endpoint, you need a valid deposit account number, the configuration ID, and other card-specific information such as the name and address of the cardholder. A newly created card has the status Unactivated. When the card is successfully created, the order status is OrderPending.
See our tutorial to learn how to create a card.
Card activation
Cards can only be used once they are activated. To activate the card, use the Activate card by ID API endpoint with the COS card ID.
See our tutorial to learn how to activate a card.
Set card PIN
Use the Set PIN API endpoint to set a customer personal identification number (PIN). This will be the customer's ATM PIN.
Card replacement
Order a replacement for damaged, lost or stolen cards using the replace API endpoint. Damaged cards remain active until the cardholder activates the replacement card. Lost or stolen cards are immediately closed and a replacement card is issued.
IMPORTANT When you replace a card, you must make the replacement card the primary card in the Cross River system to avoid issues once the card is supplied.