Skip to main content

Overview​

Manage cardholder information for your account.

Query Cardholder List​

Retrieve a list of all cardholders in your account.

cURL -X POST /card-api/v1/cardholders
-H 'Content-Type: application/json'
-H 'Authorization: {token}'
-d '{     
      "last_name": "test",
      "first_name": "test",
      "email": "test@gmail.com",
      "phone": "13800000000",
      "phone_area_code": "+86"
   }'
{
    "code": "200",
    "msg": "Success",
    "trace_id": "5596d8aa571e4c1eb57af92e9ee6cb1e",
    "data": {
        "data": [
            {
                "card_holder_id": 1925820493991116800,
                "first_name": "test",
                "last_name": "test",
                "phone_area_code": "+86",
                "phone": "13800000000",
                "email": "dev@oceanpayment.com.cn"
            },
            {
                "card_holder_id": 1925080953255141376,
                "first_name": "test",
                "last_name": "test",
                "phone_area_code": "+86",
                "phone": "13800000001",
                "email": "test@oceanpayment.com.cn"
            }
        ],
        "next_cursor": "1921822011221946368",
        "has_more": true
    }
}

Query and Update Cardholder Details​

Use the card_holder_id obtained when creating a cardholder to query or update their information.

cURL -X GET /card-api/v1/cardholders/{card_holder_id}
-H 'Content-Type: application/json'
-H 'Authorization: {token}'