Activate a personalised physical card
Learn the process for activating a personalised physical card once the user has received it. This guide explains the final step required to make the newly delivered card ready for transactions.
The user in this document pertains to both the individual and business user types.
Use Cases
- You want to activate a personalised physical card that was delivered to a user and enable it for online and offline transaction usage.
Prerequisites
- The user must have an
approvedKYC. - The user profile must be in an
activestatus. - The user profile risk assessment status must not be
risk_flagged(v1). This is not applicable in v2. - The user account or wallet must be in an
activestatus. - The physical card must be in a
pending_activationstatus. - The physical card must have already been delivered to the end user via applicable channels or modes of distribution.
API Workflow
1
Activate a personalized physical card
Collect the activation_code and card_id values returned as part of the request for the personalised physical card process.
If you need to retrieve the activation_code again, this value can be accessed using the Get Card Non-sensitive Details (GET /users/wallets/cards/{{card_id}}).
Get Card Non-sensitive Details request
curl --location 'https://{{cards_base_url}}/{{program_code}}/v1/users/wallets/cards/{{card_id}}' \
--header 'X-Auth-User-ID: {{user_id}}' \
--header 'Authorization: ••••••'
Get Card Non-sensitive Details response
{
"id": "d41d8cd98f00b204e9800998ecf8427e",
"number": "5412XXXXXXXX0012",
"holder": {
"name": "John Smith"
},
"funds": {
"available": {
"currency": "USD",
"amount": "0.00"
},
"withholding": {
"currency": "USD",
"amount": "0.00"
}
},
"type": {
"type": "{{card_type_code}}",
"name": "MatchMove Pay Persoanalised Physical Card",
"description": "MatchMove Pay Persoanalised Physical Card",
"form_factor": "physical",
"personalised_order": true
},
"token": {
"type": "CVV",
"generation": "static"
},
"date": {
"expiry": "2029-06",
"issued": "2024-06-25",
"closed": null
},
"image": {
"small": "https://assets.mmvpay.com/global/products/{{card_type_code}}/card-small.png",
"medium": "https://assets.mmvpay.com/global/products/{{card_type_code}}/card-medium.png",
"large": "https://assets.mmvpay.com/global/products/{{card_type_code}}/card-large.png"
},
"status": {
"is_active": false,
"text": "pending_activation"
},
"reason": null,
"links": [
{
"rel": "cards.pins.set",
"href": "https://beta-api.mmvpay.com/{{program_code}}/v1/users/wallets/cards/d41d8cd98f00b204e9800998ecf8427e/pins",
"method": "POST"
},
{
"rel": "cards.pins.verify",
"href": "https://beta-api.mmvpay.com/{{program_code}}/v1/users/wallets/cards/d41d8cd98f00b204e9800998ecf8427e/pins",
"method": "PUT"
},
{
"rel": "cards.activation",
"href": "https://beta-api.mmvpay.com/{{program_code}}/v1/users/wallets/cards/d41d8cd98f00b204e9800998ecf8427e",
"method": "PUT"
}
],
"activation_code": "145193",
"kit": "000004600855"
}
[Optional] Additional security and authentication measures that you can add before card activation:
- Verify the activation code — the
activation_codecan be sent to the customer in the form of an email/SMS/push as an OTP. When the customer has returned the code, you can verify if it's similar to the one in the records. - Verify the last 4 digits of the card number — Until the card is in an active state, the card number on file will be masked and only reveal the last 4 digits. You can ask for the last 4 digits of the PAN from the user and verify it against the one in the records.
When all requirements are ready and verified, call the Activate Cards (PUT /users/wallets/cards/{{card_id}}) passing the activation code and card ID of the card being activated.
Activate Cards (Personalized physical) request
curl --location --request PUT 'https://{{cards_base_url}}/{{program_code}}/v1/users/wallets/cards/{{card_id}}' \
--header 'X-Auth-User-Id: {{user_id}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: ••••••' \
--data-urlencode 'activation_code=145193'
Activate Cards (Personalized physical) response
{
"status": "success"
}
2
Display personalised physical card details to the end-user (frontend)
Even though the card is a physical product, you can still display its card details in a digital format.
Call the Get Card Non-sensitive Details (GET /users/wallets/cards/{{card_id}}) to retrieve the non-sensitive card details. Go to the Retrieve non-sensitive card information to learn more about non-sensitive card information.
Call the Get Card Sensitive Details (GET /users/wallets/cards/{{card_id}}/sensitive-data) to reveal the transaction-sensitive card information. Go to the Retrieve sensitive card information to learn more about these protected card data.
When needed, the list of card IDs associated with a user and account can be retrieved using the Get Wallet (GET /users/wallets).
Related Links
On this page
- Activate a personalised physical card