Cardholder Management

Cardholder-Create

POST /merchant/core/mcb/card/holder/create

Request

Param	Type	Required	Remark
merchantOrderNo	String	false	Merchant order number. length[20...35]
cardTypeId	Long	true	Card type ID
areaCode	String	true	Mobile phone area code. length[2...5]. Jump -> Param supportHolderAreaCode
mobile	String	true	Mobile phone number. length[5...20]
email	String	true	Email address. length[5...50]
firstName	String	true	Name. Only English characters are supported. length[2...60]
lastName	String	true	Last name. Only English characters are supported. length[2...60]
birthday	String	true	Date of birth. yyyy-MM-dd
country	String	true	Country/Region Code. Jump-> Param supportHolderRegin
town	String	true	City Code. Jump -> common_code.xlsx -> city.sheet -> code
address	String	true	Only English characters are supported. [Special characters supported: , . - /] can only contain letters, numbers, hyphens and spaces. regex: ^[A-Za-z0-9\- ]+$ length[2...40]
postCode	String	true	Postal code. length[2...10]

Response

Param	Type	Required	Remark
holderId	Long	true	Cardholder ID
merchantOrderNo	String	false	Merchant order number
cardTypeId	Long	true	Card type ID
status	String	true	Status. wait_audit: pending audit; pass_audit: passed audit; under_review: under review; reject: reject
statusStr	String	false	Status description
respMsg	String	false	remark

Example Response

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 124024,
        "cardTypeId": 124024,
        "status": "pass_audit",
        "statusStr": "Audit Pass"
    }
}

Cardholder-Update

POST /merchant/core/mcb/card/holder/update

Request

Param	Type	Required	Remark
holderId	String	true	Cardholder ID
areaCode	String	true	Mobile phone area code. length[2...5]
mobile	String	true	Mobile phone number. length[5...20]
email	String	true	Email address. length[5...50]
firstName	String	true	Name. Only English characters are supported. length[2...60]
lastName	String	true	Last name. Only English characters are supported. length[2...60]
birthday	String	true	Date of birth. yyyy-MM-dd
country	String	true	Country/Region Code
town	String	true	City Code
address	String	true	Only EnglOnly English characters are supported. [Special characters supported: , . - /] can only contain letters, numbers, hyphens and spaces. regex: ^[A-Za-z0-9\- ]+$ length[2...40]
postCode	String	true	Postal code. length[2...10]

Response

Param	Type	Required	Remark
holderId	Long	true	Cardholder ID
merchantOrderNo	String	false	Merchant order number
cardTypeId	Long	true	Card type ID
status	String	true	Status. wait_audit: pending audit; pass_audit: passed audit; under_review: under review; reject: reject
statusStr	String	false	Status description
respMsg	String	false	remark

Example Response

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 124024,
        "cardTypeId": 124024,
        "status": "pass_audit",
        "statusStr": "passed audit"
    }
}

Cardholder-Query

POST /merchant/core/mcb/card/holder/query

Request

Param	Type	Required	Remark
pageNum	Integer	true	Current page. Default is 1
pageSize	Integer	true	Number of pages per page. Maximum 100, default 10
holderId	Long	false	Cardholder ID
areaCode	String	false	Mobile phone area code. length[2...5] areaCode and mobile are passed at the same time or not
mobile	String	false	Mobile phone number. length[5...20]
email	String	false	Email address. length[5...50]
merchantOrderNo	String	false	Merchant order number

Response

Param	Type	Required	Remark
holderId	String	true	Cardholder ID
merchantOrderNo	String	false	Merchant order number
cardTypeId	String	true	Card type ID
areaCode	String	true	Mobile phone area code. length[2...5]
mobile	String	true	Mobile phone number. length[5...20]
email	String	true	Email address. length[5...50]
firstName	String	true	Name. Only English characters are supported. length[2...60]
lastName	String	true	Last name. Only English characters are supported. length[2...60]
birthday	String	true	Date of birth. yyyy-MM-dd
country	String	true	Country/Region Code
town	String	true	City Code
address	String	true	address
postCode	String	true	Postal code. length[2...10]
status	String	true	Status. wait_audit: pending audit; pass_audit: passed audit; under_review: under review; reject: rejected
statusStr	String	true	Status description
respMsg	String	false	remark
createTime	Long	true	Creation time. Milliseconds
updateTime	Long	true	Update time. Millisecond timestamp

Example Response

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 102424,
        "cardTypeId": 102424,
        "areaCode": "+852",
        "mobile": "875692311",
        "email": "[e-mail]",
        "firstName": "elly",
        "lastName": "tom",
        "birthday": "1990-10-10",
        "country": "HK",
        "countryStr": "Hongkong",
        "town": "HK_KKC_1",
        "townStr": "九龙城区",
        "address": "Shop G02",
        "postCode": "999077",
        "status": "pass_audit",
        "statusStr": "Approved",
        "createTime": 232413142131,
        "updateTime": 232413142131
    }
}