curl --request GET \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/U202605220001/info \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token'
{
"code": 0,
"msg": "Success",
"data": {
"cardholder_no": "",
"cardholder_unique_no": "",
"email": "",
"status": "Approved",
"total_balance": "1000.00",
"time": 1716307200000,
"card_list": [{"card_no": "", "card_last_no": "", "card_type": "Virtual", "time": 1716307200000}],
"account_list": [{"balance": "500.00", "usd_balance": "500.00"}]
}
}
Cardholder
Get Cardholder Details
GET
/
open-api
/
v1
/
cardholder
/
{cardholder_no}
/
info
curl --request GET \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/U202605220001/info \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token'
{
"code": 0,
"msg": "Success",
"data": {
"cardholder_no": "",
"cardholder_unique_no": "",
"email": "",
"status": "Approved",
"total_balance": "1000.00",
"time": 1716307200000,
"card_list": [{"card_no": "", "card_last_no": "", "card_type": "Virtual", "time": 1716307200000}],
"account_list": [{"balance": "500.00", "usd_balance": "500.00"}]
}
}
Retrieves cardholder details, including accounts and the list of successfully issued cards.
Request Headers
string
required
apiKey (merchant credential, bound to IP whitelist)
string
required
Unix timestamp in milliseconds. The deviation from the server time must be within 60 seconds, and future timestamps are not accepted.
string
required
Login token (required for all interfaces except Get Token).
string
default:"application/json"
Fixed to
application/jsonPath Parameters
string
required
Cardholder order number.
Response Parameters
number
Response status code.
0 indicates success.string
Response message.
object
Response data.
Show data
Show data
string
Cardholder order number
string
Merchant-side unique cardholder number
string
Email
string
Cardholder status, see [Appendix - Constants] Cardholder Status
string
Total account balance (USD)
number
Cardholder creation time (Unix milliseconds)
object[]
curl --request GET \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/U202605220001/info \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token'
{
"code": 0,
"msg": "Success",
"data": {
"cardholder_no": "",
"cardholder_unique_no": "",
"email": "",
"status": "Approved",
"total_balance": "1000.00",
"time": 1716307200000,
"card_list": [{"card_no": "", "card_last_no": "", "card_type": "Virtual", "time": 1716307200000}],
"account_list": [{"balance": "500.00", "usd_balance": "500.00"}]
}
}