Manage cards
Understand the various lifecycle operations available for managing user cards. This guide provides an overview of post-issuance actions, from setting controls to changing a card's state.
Enable your users to fully control their cards from your mobile or web app
The Managing Cards section allows users to perform essential actions on payment cards associated with their account. These functionalities allow users to suspend, unsuspend, block/delete, or reactivate cards as needed. This section provides the necessary tools for efficiently managing card-related operations within the application.
Card Info
Every card has information associated with it that is confidential. In addition to ensuring the security of end users for issuing cards, the MatchMove platform provides an additional level of security by providing two endpoints for showing the card information. The Get Card Details (GET v1/users/wallets/cards/{card_id}) API can be used to just display basic information in your application for your end user.
When the user intends to use the card information to make payments, the required information is exposed via Get Sensitive Card Data (GET /v2/users/wallets/cards/{card_id}/sensitive-data) API. The API returns information in an encrypted manner, which you can then decrypt and show to your end users. This ensures proper end-to-end security for your users and ensures their details are safe
Card statuses
As part of the issuance and general lifecycle of the card, the card transitions to various statuses. These statuses control what that card can be used for.
| The card can only be activated at this point. No functionality other than activating a card is allowed at this point in time |
| All functionality for the card is allowed. |
| No new transaction can be authorized by the card Any pending settlements will still be processed. |
| No new transaction can be authorized No settlements can be posted against the card. |
Card PIN
A card PIN is a 4 to 6-digit secret code that verifies the cardholder during transactions. A card PIN is the personal code you enter at an ATM or point‑of‑sale terminal to prove the card is yours. It’s checked by the MatchMove platform to authorize certain transactions, especially chip‑and‑PIN with an EMV chip. Transactions eligible for PIN are dependent on multiple factors, ranging from where the card is issued, the country where it is swiped, and the law of the land, as well as the profile associated with the card printing process.
MatchMove Platform is currently configured to support 4-digit pins. If your end user encounters a machine that mandates a six-digit PIN, you are recommended to ask the user to prefix 00 the PIN when entering the information in the terminal. Ensure that at the point of setting the PIN, you communicate to the user to use 4 digits for setting the PIN.
Related Links
On this page
- Manage cards