Get Cardholder Details

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"}]
  }
}

GET

open-api

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

string

default:"application/json"

Fixed to application/json

Path Parameters

string

required

Cardholder order number.

Response Parameters

number

Response status code. 0 indicates success.

string

Response message.

object

Response data.

Show data

string

Cardholder order number

string

Merchant-side unique cardholder number

string

Cardholder status, see [Appendix - Constants] Cardholder Status

string

Total account balance (USD)

number

Cardholder creation time (Unix milliseconds)

object[]

Successfully issued card list.

Show card_list

string

Card order number

string

Last four digits of card number

string

Card type, see [Appendix - Constants] Card Types

number

Card creation time (Unix milliseconds)

object[]

Account list.

Show account_list

string

Currency amount

string

USD amount

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"}]
  }
}

Getting Started

API Documentation

Appendix

Request Headers

Path Parameters

Response Parameters

​Request Headers

​Path Parameters

​Response Parameters

Request Headers

Path Parameters

Response Parameters