There are a number of scenarios which may require you to take additional actions on a specific card after it has been issued to a cardholder including activation, renewal, suspension, and termination. Each of these scenarios is outlined below with accompanying examples.
active
. Optionally, a PIN number can also be set for the card at this time by passing a pin
value in the JSON body of the request.
suspended
. Any authorizations received while a card is suspended will be denied; however, refunds will still be processed. Cards that have been suspended can be reactivated by setting their status back to active
.
terminated
. Once a card has been terminated, it cannot be reactivated, and all future transactions will be denied.
pin
value. Once the PIN has been set, the value of the pin_is_set
property of the Card object will be changed to true
. This same method can be used to update an existing PIN.
expiration
date or has been damaged and requires replacement, you will need to submit a request to issue a new card. Cards may not be renewed beyond their original listed expiration.
expiration
listed on a card, it is best practice to proactively issue a new card to the cardholder.
When the cardholder receives a new card, you can allow the user to activate it through your app UI before terminating the expiring card. This ensures that the user has continued debit card access to their account.
Note that it is not possible to issue a new card with the same PAN as a previously issued card.
suspended
, temporarily preventing any further transactions from being approved. Alternatively, a card can be terminated to permanently prevent any future transactions from being made on the original card. If desired, a new card can then be issued.
pan
and cvv
in the card object fields will return a value of null. If you need to retrieve or display this information, you have two options: retrieving the PAN and CVV; or using the Marqeta.js widget.
pan
and cvv
values by making a request to /card/:id
and passing values of “true” for show_pan
and show_cvv
in the query string parameters.