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 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 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 personalised 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 Details (GET /users/wallets/cards/{{card_id}}).
Get Card Details request
curl --location 'https://{{cards_base_url}}/{{product_code}}/v1/users/wallets/cards/{{card_id}}' \
--header 'X-Auth-User-ID: {{user_id}}' \
--header 'Authorization: ••••••'Get Card 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/{{product_code}}/v1/users/wallets/cards/d41d8cd98f00b204e9800998ecf8427e/pins",
"method": "POST"
},
{
"rel": "cards.pins.verify",
"href": "https://beta-api.mmvpay.com/{{product_code}}/v1/users/wallets/cards/d41d8cd98f00b204e9800998ecf8427e/pins",
"method": "PUT"
},
{
"rel": "cards.activation",
"href": "https://beta-api.mmvpay.com/{{product_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 Card (PUT /users/wallets/cards/{{card_id}}) passing the activation code and card ID of the card being activated.
Activate Card (Personalized physical) request
curl --location --request PUT 'https://{{cards_base_url}}/{{product_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 Card (Personalized physical) response
{
"status": "success"
}2
Display personalised physical card details to the end-user (frontend)
Even though the card is of a physical product, you can still display its card details in a digital format.
Call the Get Card 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 Retrieve 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 ID 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