Access account information
Learn how to access information for a specific user account. Understand the process for retrieving key details such as the account status and available balances.
The user in this document pertains to both the individual and business user types.
Use Cases
- You want to retrieve the account details of a specific user.
- You want to retrieve the outstanding balance of an account belonging to a specific user.
- You want to retrieve the outstanding transaction limits available for a specific user account.
- You want to retrieve the list of cards associated with a specific user account.
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.
API Workflow
1
Retrieve customer account details
The customer account or wallet is the main financial asset that enables all financial capabilities in the platform. Thus, the wallet will be linked to all other financial instruments that are owned by the same user.
Call Get Wallet (GET /users/wallets) to get the full account or wallet details of the customer.
Get Account / Wallet request
CURL
curl --location 'https://{{accounts_base_url}}/{{program_code}}/v1/users/wallets' \
--header 'X-Auth-User-ID: {{user_id}}' \
--header 'Authorization: ••••••'Get Account / Wallet response
JSON
{
"funds": {
"available": {
"currency": "SGD",
"amount": "0.00"
},
"withholding": {
"currency": "SGD",
"amount": "0.00"
},
"categories": {
"DEFAULT": {
"available": {
"currency": "SGD",
"amount": "0.00"
},
"withholding": {
"currency": "SGD",
"amount": "0.00"
}
}
}
},
"id": "e4fe41fbdd28ce09fe2f7aa27b2299e5",
"number": "6377021438215970",
"holder": {
"name": "John Smith"
},
"token": {
"type": "CVV",
"generation": "dynamic"
},
"date": {
"expiry": "2028-12",
"issued": "2023-12-19",
"closed": null
},
"image": {
"small": "https://assets.mmvpay.com/global/products/<program_code>/card-small.png",
"medium": "https://assets.mmvpay.com/global/products/<program_code>/card-medium.png",
"large": "https://assets.mmvpay.com/global/products/<program_code>/card-large.png"
},
"status": {
"is_active": true,
"text": "active"
},
"reason": null,
"details": {
"max_load_limit": null,
"network_type": "MatchMove",
"fee": "0.00",
"fee_currency": "SGD",
"purse": {
"pre_kyc": {
"purse_max_limit": 1000
},
"post_kyc": {
"purse_max_limit": 100000
}
},
"topup_limits": {
"pre_kyc": {
"unit_transactional_limit": 1000,
"daily_transactional_limit": 3000,
"daily_count_limit": null,
"weekly_transactional_limit": 3000,
"weekly_count_limit": null,
"monthly_transactional_limit": 3000,
"monthly_count_limit": null,
"annual_transactional_limit": 20000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 1
},
"post_kyc": {
"unit_transactional_limit": 1000000,
"daily_transactional_limit": 1000000,
"daily_count_limit": null,
"weekly_transactional_limit": 7000000,
"weekly_count_limit": null,
"monthly_transactional_limit": 30000000,
"monthly_count_limit": null,
"annual_transactional_limit": 50000000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 1
},
"current": {
"lifetime_transactional": 0,
"lifetime_count": 0,
"daily_transactional": 0,
"daily_count": 0,
"weekly_transactional": 0,
"weekly_count": 0,
"monthly_transactional": 0,
"monthly_count": 0,
"annual_transactional": 0,
"annual_count": 0
}
},
"deduct_limits": {
"pre_kyc": {
"unit_transactional_limit": 1000,
"daily_transactional_limit": 3000,
"daily_count_limit": null,
"weekly_transactional_limit": 3000,
"weekly_count_limit": null,
"monthly_transactional_limit": 3000,
"monthly_count_limit": null,
"annual_transactional_limit": 20000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 1
},
"post_kyc": {
"unit_transactional_limit": 1000000,
"daily_transactional_limit": 1000000,
"daily_count_limit": null,
"weekly_transactional_limit": 7000000,
"weekly_count_limit": null,
"monthly_transactional_limit": 30000000,
"monthly_count_limit": null,
"annual_transactional_limit": 50000000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 1
},
"current": {
"lifetime_transactional": 0,
"lifetime_count": 0,
"daily_transactional": 0,
"daily_count": 0,
"weekly_transactional": 0,
"weekly_count": 0,
"monthly_transactional": 0,
"monthly_count": 0,
"annual_transactional": 0,
"annual_count": 0
}
},
"remittance_limits": {
"pre_kyc": {
"unit_transactional_limit": 0,
"daily_transactional_limit": 0,
"daily_count_limit": null,
"weekly_transactional_limit": 0,
"weekly_count_limit": null,
"monthly_transactional_limit": 0,
"monthly_count_limit": null,
"annual_transactional_limit": null,
"annual_count_limit": null,
"lifetime_transactional_limit": 0,
"lifetime_count_limit": null,
"allowed": 0
},
"post_kyc": {
"unit_transactional_limit": 0,
"daily_transactional_limit": 0,
"daily_count_limit": null,
"weekly_transactional_limit": 0,
"weekly_count_limit": null,
"monthly_transactional_limit": 0,
"monthly_count_limit": null,
"annual_transactional_limit": null,
"annual_count_limit": null,
"lifetime_transactional_limit": 0,
"lifetime_count_limit": null,
"allowed": 0
},
"current": {
"lifetime_transactional": 0,
"lifetime_count": 0,
"daily_transactional": 0,
"daily_count": 0,
"weekly_transactional": 0,
"weekly_count": 0,
"monthly_transactional": 0,
"monthly_count": 0,
"annual_transactional": 0,
"annual_count": 0
}
},
"transfer_in_limits": {
"pre_kyc": {
"unit_transactional_limit": 1000,
"daily_transactional_limit": 3000,
"daily_count_limit": null,
"weekly_transactional_limit": 3000,
"weekly_count_limit": null,
"monthly_transactional_limit": 3000,
"monthly_count_limit": null,
"annual_transactional_limit": 20000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 1
},
"post_kyc": {
"unit_transactional_limit": 1000000,
"daily_transactional_limit": 1000000,
"daily_count_limit": null,
"weekly_transactional_limit": 7000000,
"weekly_count_limit": null,
"monthly_transactional_limit": 30000000,
"monthly_count_limit": null,
"annual_transactional_limit": 50000000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 1
},
"current": {
"lifetime_transactional": 0,
"lifetime_count": 0,
"daily_transactional": 0,
"daily_count": 0,
"weekly_transactional": 0,
"weekly_count": 0,
"monthly_transactional": 0,
"monthly_count": 0,
"annual_transactional": 0,
"annual_count": 0
}
},
"transfer_out_limits": {
"pre_kyc": {
"unit_transactional_limit": 1000,
"daily_transactional_limit": 3000,
"daily_count_limit": null,
"weekly_transactional_limit": 3000,
"weekly_count_limit": null,
"monthly_transactional_limit": 3000,
"monthly_count_limit": null,
"annual_transactional_limit": 20000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 1
},
"post_kyc": {
"unit_transactional_limit": 1000000,
"daily_transactional_limit": 1000000,
"daily_count_limit": null,
"weekly_transactional_limit": 7000000,
"weekly_count_limit": null,
"monthly_transactional_limit": 30000000,
"monthly_count_limit": null,
"annual_transactional_limit": 50000000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 1
},
"current": {
"lifetime_transactional": 0,
"lifetime_count": 0,
"daily_transactional": 0,
"daily_count": 0,
"weekly_transactional": 0,
"weekly_count": 0,
"monthly_transactional": 0,
"monthly_count": 0,
"annual_transactional": 0,
"annual_count": 0
}
},
"load_limits": {
"pre_kyc": {
"unit_transactional_limit": 1000,
"daily_transactional_limit": 3000,
"daily_count_limit": null,
"weekly_transactional_limit": 3000,
"weekly_count_limit": null,
"monthly_transactional_limit": 3000,
"monthly_count_limit": null,
"annual_transactional_limit": 20000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 0
},
"post_kyc": {
"unit_transactional_limit": 1000000,
"daily_transactional_limit": 1000000,
"daily_count_limit": null,
"weekly_transactional_limit": 7000000,
"weekly_count_limit": null,
"monthly_transactional_limit": 30000000,
"monthly_count_limit": null,
"annual_transactional_limit": 50000000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 0
},
"current": {
"lifetime_transactional": 0,
"lifetime_count": 0,
"daily_transactional": 0,
"daily_count": 0,
"weekly_transactional": 0,
"weekly_count": 0,
"monthly_transactional": 0,
"monthly_count": 0,
"annual_transactional": 0,
"annual_count": 0
}
},
"unload_limits": {
"pre_kyc": {
"unit_transactional_limit": 1000,
"daily_transactional_limit": 3000,
"daily_count_limit": null,
"weekly_transactional_limit": 3000,
"weekly_count_limit": null,
"monthly_transactional_limit": 3000,
"monthly_count_limit": null,
"annual_transactional_limit": 20000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 0
},
"post_kyc": {
"unit_transactional_limit": 1000000,
"daily_transactional_limit": 1000000,
"daily_count_limit": null,
"weekly_transactional_limit": 7000000,
"weekly_count_limit": null,
"monthly_transactional_limit": 30000000,
"monthly_count_limit": null,
"annual_transactional_limit": 50000000,
"annual_count_limit": null,
"lifetime_transactional_limit": null,
"lifetime_count_limit": null,
"allowed": 0
},
"current": {
"lifetime_transactional": 0,
"lifetime_count": 0,
"daily_transactional": 0,
"daily_count": 0,
"weekly_transactional": 0,
"weekly_count": 0,
"monthly_transactional": 0,
"monthly_count": 0,
"annual_transactional": 0,
"annual_count": 0
}
},
"reversal_limits": {
"current": {
"lifetime_count": 0,
"lifetime_transactional": 0,
"daily_count": 0,
"daily_transactional": 0,
"weekly_count": 0,
"weekly_transactional": 0,
"monthly_count": 0,
"monthly_transactional": 0
}
},
"refund_limits": {
"current": {
"lifetime_count": 0,
"lifetime_transactional": 0,
"daily_count": 0,
"daily_transactional": 0,
"weekly_count": 0,
"weekly_transactional": 0,
"monthly_count": 0,
"monthly_transactional": 0
}
},
"issuance_limits": {
"<card_type_code>": {
"pre_kyc": {
"allowed": 1,
"daily_count_limit": null,
"weekly_count_limit": null,
"monthly_count_limit": null,
"yearly_count_limit": null,
"lifetime_count_limit": null
},
"rules": [],
"post_kyc": {
"allowed": 1,
"daily_count_limit": null,
"weekly_count_limit": null,
"monthly_count_limit": null,
"yearly_count_limit": null,
"lifetime_count_limit": null
},
"current": {
"daily_count": 0,
"weekly_count": 0,
"monthly_count": 0,
"yearly_count": 0,
"lifetime_count": 1
}
}
},
"active_limits": {
"<card_type_code>": {
"allowed": 1,
"pre_kyc": 5,
"post_kyc": 5,
"current": 1
}
}
},
"kit": "000004014410",
"cards": [
{
"id": "b846591162a0fc71b2c179bd5d9ad424",
"status": {
"is_active": true,
"text": "active"
},
"type": [
{
"rel": "self",
"href": "https://beta-api.mmvpay.com/<program_code>/v1/users/wallets/cards/types/homeezmccard",
"method": "GET"
}
],
"links": [
{
"rel": "self",
"href": "https://beta-api.mmvpay.com/<program_code>/v1/users/wallets/cards/b846591162a0fc71b2c179bd5d9ad424",
"method": "GET"
}
]
}
]
}Related Links
Was this section helpful?
On this page
- Access account information