Card issuing overview

9min
cross river card issuing lets you offer customers different types of debit card products these products, known as instrument types , include contact less and virtual cards cr card issuing in our banking core uses i2c as the payment processor, but can adapt to other card processors card configuration manage your customer's cards by working with cr to decide what you want to offer, such as physical or virtual cards this is the card configuration cr creates a card configuration profile for youfor each instrument type you choose for your customers once created, we give you a configurationid for each instrument type you are offering you needthis configuration id when asking cos to create a new card for a customer card creation to create a card docid\ xjjd9yejaryomikeldahj , 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 is not activated card activation and issuing cards can only be used once they are activate a card docid 7odv4poiincuqu8xdyrp0 to activate the card, use the card issuing docid\ ap2akoyeot12me1ydsij0 endpoint with the cos card id card status cards include different types of status the status (card status) and the order status these indicate different things the card status also contributes to the card issuing overview docid\ pze4nyany9uiyfuoldqbf 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 cr 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 docid\ dgnysfx9f7pnesmuxnwsp to receive a webhook 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 card replacement and cancellation order a replacement for damaged, lost or stolen cards using the replace 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 cr system to avoid issues once the card is supplied set card pin use the pin endpoint to set a customer personal identification number (pin) this will be the customer's atm pin apis see the card issuing docid\ ap2akoyeot12me1ydsij0