This request updates a card's status.
Click here to learn more about this request
Once a card is associated with a line of credit account and borrower, this endpoint is used to provide card controls. This request uses an LMS endpoint, but card status information is automatically updated in both LoanPro and Secure Payments.
A card's status determines whether it can be used in future transactions. For cards that have been stolen, lost, or canceled, a new card can be generated. For information on generating new cards, see Create card in LMS + SP ↗
💭 Want to be generate a webhook when a card is updated?
A native Card update webhook exists within Secure Payments, which can push information to an external source. Take a look at our Secure Payments Events ↗ article to learn more.
Statuses
Here's a breakdown of the available card status options and how they affect the approval of transactions:
| Card Status + Description | Corresponding Enumerated Value | Transactions allowed? |
|---|---|---|
| Active The card has been activated by the borrower an is valid for use. | active | Yes ✅ |
| Stolen The card has been reported as stolen by the borrower. If the card is found, its status can return to active to enable usage.If the card is not found, a new card will be generated. The new card will have a new card number, expiration date, and CVV. | stolen | No ❌ |
| Lost The card has been reported as misplaced by the borrower. If the card is found, its status can return to active to enable usage.If the card is not found, a new card will be generated. The new card can keep the existing card number, but a new expiration date and CVV will be generated. | lost | No ❌ |
| Blocked The card has been temporarily blocked or "frozen" by the borrower. This status is used for scenarios where the card will be approved for usage in the near future. Unfreeze a card by returning its status to active. | blocked | No ❌ |
| Inactive The card has been created, but it has not yet been activated by the borrower. | inactive | No ❌ |
| Canceled The card will be permanently set as unusable. A replacement card can be generated later if necessary. | canceled | No ❌ |