Manage card status

This request updates a card's status.

 Click here to learn more about managing cards

Managing Card Statuses

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, allowing you to 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 + DescriptionCorresponding Enumerated ValueTransactions allowed?
Active
The card has been activated by the borrower an is valid for use.
activeYes ✅
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.
stolenNo ❌
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.
lostNo ❌
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.
blockedNo ❌
Inactive
The card has been created, but it has not yet been activated by the borrower.
inactiveNo ❌
Canceled
The card will be permanently set as unusable. A replacement card can be generated later if necessary.
canceledNo ❌
Language
Authorization
Click Try It! to start a request and see the response here!