Retrieve non-sensitive card information
Understand how to securely retrieve non-sensitive information for a specific card for display in your application. This guide covers accessing details like the last four digits and cardholder name without exposing transaction-critical data.
The user in this document pertains to both the individual and business user types.
Use Cases
- You want to retrieve the non-sensitive and transaction-non-critical details of a specific card.
- You want to retrieve the card status and form details of a specific card.
- You want to display a visual image of the card, along with the non-sensitive data, in your application.
Prerequisites
- The user profile risk assessment status must not be
risk_flagged. - The user profile must be in an
activestatus. - The user must have an
approvedKYC or KYB status. - The user account or wallet must be in an
activestatus. - The user card must be in an
activestatus.
API Workflow
1
Retrieve the non-sensitive card details
Call the Get Card Details (GET /users/wallets/cards/{{card_id}}) by passing the card_id to retrieve the non-sensitive card details.
Non-sensitive card details
| The card_id or the card identifier generated for the card |
| The masked card number or PAN of the card |
| The cardholder's name |
| The card type and form factor details |
| The issuance and expiry date of the card |
| The card form image |
| The current card status |
The list of card IDs associated with a user and account can be retrieved using the Get Wallet (GET /users/wallets)
Get Card Details API request
curl --location 'https://{{cards_base_url}}/{{program_code}}/v1/users/wallets/cards/d41d8cd98f00b204e9800998ecf8427e' \
--header 'X-Auth-User-ID: {{user_id}}' \
--header 'Authorization: ••••••'Get Card Details API response
{
"id": "d41d8cd98f00b204e9800998ecf8427e",
"number": "5412XXXXXXXX0012",
"holder": {
"name": "John Doe"
},
"type": {
"code": "sgmmdemomcppcard",
"name": "MatchMove Personalized Physical Card",
"description": "MatchMove Personalized Physical Card",
"form_factor": "physical",
"personalised_order": true
},
"token": {
"type": "CVV",
"generation": "static"
},
"date": {
"expiry": "2030-01",
"issued": "2030-01-01",
"closed": null
},
"image": {
"small": "https://assets.mmvpay.com/global/products/sgmmdemomcppcard/card-small.png",
"medium": "https://assets.mmvpay.com/global/products/sgmmdemomcppcard/card-medium.png",
"large": "https://assets.mmvpay.com/global/products/sgmmdemomcppcard/card-large.png"
},
"status": {
"is_active": true,
"text": "active",
},
"activation_code": "123456",
"kit": "000012342122"
}You can use this non-sensitive card information to render the card form displaying the basic information to the user.
Related Links
On this page
- Retrieve non-sensitive card information