持卡人模块

持卡人-创建

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

请求

参数	类型	是否必传	备注
merchantOrderNo	String	否	商户订单号。[20...35]位
cardTypeId	Long	是	卡片类型ID
areaCode	String	是	手机区号。[2...5]位
mobile	String	是	手机号。[5...20]位 传送门 -> Param supportHolderAreaCode
email	String	是	邮箱。[5...50]位
firstName	String	是	名。只支持英文字符。[2...60]位
lastName	String	是	姓。只支持英文字符。[2...60]位
birthday	String	是	出生日期。yyyy-MM-dd
country	String	是	国家/地区代码。 传送门 -> Param supportHolderRegin
town	String	是	城市代码。 传送门 -> common_code.xlsx -> city.sheet -> code 传送门2
address	String	是	地址。 只支持英文字符。【特殊字符支持, . - /】 只能包含字母、数字、连字符和空格。regex: ^[A-Za-z0-9\- ]+$ 长度[2...40]位
postCode	String	是	邮编。[2...10]位

响应

参数	类型	是否必传	备注
holderId	Long	是	持卡人id
merchantOrderNo	String	否	商户订单号
cardTypeId	Long	是	卡片类型id
status	String	是	状态。 wait_audit: 待审核; pass_audit: 审核通过; under_review: 审核中; reject: 拒绝
statusStr	String	否	状态描述
respMsg	String	否	备注

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 124024,
        "merchantOrderNo": "343jfaoigjawg3423535",
        "cardTypeId": 1110006,
        "status": "pass_audit",
        "statusStr": "审核通过"
    }
}

持卡人-更新

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

请求

参数	类型	是否必传	备注
holderId	Long	是	持卡人id
areaCode	String	是	手机区号。[2...5]位
mobile	String	是	手机号。[5...20]位
email	String	是	邮箱。[5...50]位
firstName	String	是	名。只支持英文字符。[2...60]位
lastName	String	是	姓。只支持英文字符。[2...60]位
birthday	String	是	出生日期。yyyy-MM-dd
country	String	是	国家/地区代码。 传送门 -> common_code.xlsx -> region.sheet -> code 传送门2
town	String	是	城市代码
address	String	是	地址。 只支持英文字符。【特殊字符支持, . - /】 只能包含字母、数字、连字符和空格。regex: ^[A-Za-z0-9\- ]+$ 长度[2...40]位
postCode	String	是	邮编。[2...10]位

响应

参数	类型	是否必传	备注
holderId	Long	是	持卡人id
merchantOrderNo	String	否	商户订单号
cardTypeId	Long	是	卡片类型id
status	String	是	状态。 wait_audit: 待审核; pass_audit: 审核通过; under_review: 审核中; reject: 拒绝
statusStr	String	否	状态描述
respMsg	String	否	备注

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 124024,
        "merchantOrderNo": "253nni3on53no3i53on535",
        "cardTypeId": 1110006
        "status": "pass_audit",
        "statusStr": "审核通过"
    }
}

持卡人-查询

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

请求

参数	类型	是否必传	备注
pageNum	Integer	是	当前页。默认1
pageSize	Integer	是	每页数量。最大100，默认10
holderId	Long	否	持卡人id
merchantOrderNo	String	否	商户订单号
areaCode	String	否	手机区号。[2...5]位 areaCode和mobile同时传参或不传
mobile	String	否	手机号。[5...20]位
email	String	否	邮箱。[5...50]位

响应

参数	类型	是否必传	备注
holderId	Long	是	持卡人id
merchantOrderNo	String	否	商户订单号
cardTypeId	Long	是	卡片类型id
areaCode	String	是	手机区号。[2...5]位
mobile	String	是	手机号。[5...20]位
email	String	是	邮箱。[5...50]位
firstName	String	是	名。只支持英文字符。[2...60]位
lastName	String	是	姓。只支持英文字符。[2...60]位
birthday	String	是	出生日期。yyyy-MM-dd
country	String	是	国家/地区代码
countryStr	String	是	国家/地区
town	String	是	城市代码
townStr	String	是	城市
address	String	是	地址。
postCode	String	是	邮编。[2...10]位
status	String	是	状态。 wait_audit: 待审核; pass_audit: 审核通过; under_review: 审核中; reject: 拒绝
statusStr	String	是	状态描述
respMsg	String	否	备注
createTime	Long	是	创建时间。毫秒时间戳
updateTime	Long	是	更新时间。毫秒时间戳

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 102424,
        "merchantOrderNo": "24353647ksglsan3535",
        "cardTypeId": 102424,
        "areaCode": "+852",
        "mobile": "875692311",
        "email": "[e-mail]",
        "firstName": "elly",
        "lastName": "tom",
        "birthday": "1990-10-10",
        "country": "HK",
        "countryStr": "香港",
        "town": "HK_KKC_1",
        "townStr": "九龙城区",
        "address": "Shop G02, G/F, Kowloon City District, Hong Kong SAR, China, 63 Ma Tau Wai Road, To Kwa Wan, Kowloon, Hong Kong",
        "postCode": "999077",
        "status": "pass_audit",
        "statusStr": "审核通过",
        "respMsg": null,
        "createTime": 232413142131,
        "updateTime": 232413142131
    }
}