持卡人模块

持卡人-职业

POST /merchant/core/mcb/card/holder/occupations

请求

参数

类型

是否必传

备注

响应

参数

类型

是否必传

备注

occupationCode

String

是

职业code

description

String

是

职业

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "occupationCode": "11-1011",
            "description": "Chief Executives"
        }
    ]
}

持卡人-创建-v1

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

请求

参数

类型

是否必传

备注

merchantOrderNo

String

否

商户订单号。[20...35]位

cardTypeId

Long

是

卡片类型ID

areaCode

String

是

手机区号。[2...5]位取支持的卡BIN接口参数 supportHolderAreaCode

mobile

String

是

手机号。[5...20]位

String

是

邮箱。需要接收验证码 [5...50]位

firstName

String

是

名。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

lastName

String

是

姓。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

birthday

String

是

出生日期。yyyy-MM-dd

country

String

是

国家/地区代码。取支持的卡BIN接口参数 supportHolderRegin

town

String

是

城市代码。取城市列表 code参数

address

String

是

地址。长度[2...40]位只能包含字母、数字、连字符和空格。 regex: ^[A-Za-z0-9\- ]+$

postCode

String

是

邮编。[2...10]位

响应

参数

类型

是否必传

备注

holderId

Long

是

持卡人id

merchantOrderNo

String

否

商户订单号

cardTypeId

Long

是

卡片类型id

statusFlowLocation

String

是

审核流位置。只有当statusFlowLocation=admin且status=reject才支持更新持卡人 admin：平台审核； channel：银行审核

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,
        "statusFlowLocation": "admin",
        "status": "pass_audit",
        "statusStr": "审核通过",
        "respMsg": "SUCCESS"
    }
}

持卡人-更新-v1

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

请求

参数

类型

是否必传

备注

holderId

Long

是

持卡人id

areaCode

String

是

手机区号。[2...5]位取支持的卡BIN接口参数 supportHolderAreaCode

mobile

String

是

手机号。[5...20]位

String

是

邮箱。需要接收验证码[5...50]位

firstName

String

是

名。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

lastName

String

是

姓。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

birthday

String

是

出生日期。yyyy-MM-dd

country

String

是

国家/地区代码。取支持的卡BIN接口参数 supportHolderRegin

town

String

是

城市代码。取城市列表 code参数

address

String

是

地址。长度[2...40]位只能包含字母、数字、连字符和空格。 regex: ^[A-Za-z0-9\- ]+$

postCode

String

是

邮编。[2...10]位

响应

参数

类型

是否必传

备注

holderId

Long

是

持卡人id

merchantOrderNo

String

否

商户订单号

cardTypeId

Long

是

卡片类型id

statusFlowLocation

String

是

审核流位置。只有当statusFlowLocation=admin且status=reject才支持更新持卡人 admin：平台审核； channel：银行审核

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,
        "statusFlowLocation": "admin",
        "status": "pass_audit",
        "statusStr": "审核通过",
        "respMsg": "SUCCESS"
    }
}

持卡人-创建-v2

请真实填写持卡人信息，持卡人提交到银行后不支持修改任何信息。并且在同一个卡类型（cardTypeId）下邮箱全局唯一、身份证件号码全局唯一。比如用户从A渠道提交了test@gmail.com邮箱，在从B渠道提交相同邮箱将被拒绝。

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

请求

参数

类型

是否必传

备注

merchantOrderNo

String

是

商户订单号。[20...35]位

cardTypeId

Long

是

卡片类型ID

areaCode

String

是

手机区号。[2...5]位取支持的卡BIN接口参数 supportHolderAreaCode

mobile

String

是

手机号。[5...20]位

String

是

邮箱。需要接收验证码[5...50]位

firstName

String

是

名。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

lastName

String

是

姓。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

birthday

String

是

出生日期。yyyy-MM-dd

nationality

String

是

国籍代码。ISO 3166-1 alpha-2 取支持的卡BIN接口参数 supportHolderRegin

country

String

是

账单地址的国家/地区代码。ISO 3166-1 alpha-2 取支持的卡BIN接口参数 supportHolderRegin

town

String

是

账单地址的城市代码。取城市列表 code参数

address

String

是

账单地址。只能包含字母、数字、连字符和空格。 regex: ^[A-Za-z0-9\- ]+$ 长度[2...40]位

postCode

String

是

账单地址邮编。[2...10]位

gender

String

是

性别。M-男；F-女

occupation

String

是

职业。取持卡人职业 occupationCode 参数

annualSalary

String

是

年薪。例：200000 USD

accountPurpose

String

是

帐户用途。只支持英文，例如：Living Expense

expectedMonthlyVolume

String

是

预期月交易量。100000 USD

idType

String

是

证件类型。 PASSPORT：护照 HK_HKID：香港身份证 DLN：DLN（只支持美国国籍） GOVERNMENT_ISSUED_ID_CARD：政府签发的身份证

idNumber

String

是

证件证号。[2...50]位

ssn

String

否

安全号码。如果签发国是美国，则需要 9 位数的 SSN

issueDate

String

是

id证件签发日期。yyyy-MM-dd

idNoExpiryDate

String

是

证件过期日期。yyyy-MM-dd

idFrontId

String

是

证件照正面照片文件ID。调用 上传文件接口 获取

idBackId

String

是

证件照背面照片文件ID。调用 上传文件接口 获取

idHoldId

String

是

手持证件照文件ID。调用 上传文件接口 获取

ipAddress

String

是

IPV4地址。

响应

参数

类型

是否必传

备注

holderId

Long

是

持卡人id

merchantOrderNo

String

是

商户订单号

cardTypeId

Long

是

卡片类型id

statusFlowLocation

String

是

审核流位置。只有当statusFlowLocation=admin且status=reject才支持更新持卡人 admin：平台审核； channel：银行审核

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,
        "statusFlowLocation": "admin",
        "status": "pass_audit",
        "statusStr": "审核通过",
        "respMsg": "SUCCESS"
    }
}

持卡人-更新-v2

只有当statusFlowLocation=admin且status=reject才支持更新持卡人

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

请求

参数

类型

是否必传

备注

holderId

Long

是

持卡人ID

areaCode

String

是

手机区号。[2...5]位取支持的卡BIN接口参数 supportHolderAreaCode

mobile

String

是

手机号。[5...20]位

String

是

邮箱。需要接收验证码[5...50]位

firstName

String

是

名。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

lastName

String

是

姓。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

birthday

String

是

出生日期。yyyy-MM-dd

nationality

String

是

国籍代码。ISO 3166-1 alpha-2 取支持的卡BIN接口 -> 返回参数 supportHolderRegin

country

String

是

账单地址的国家/地区代码。ISO 3166-1 alpha-2 取支持的卡BIN接口 -> 返回参数 supportHolderRegin

town

String

是

账单地址的城市代码。取 城市列表 code参数

address

String

是

账单地址。只能包含字母、数字、连字符和空格。 regex: ^[A-Za-z0-9\- ]+$ 长度[2...40]位

postCode

String

是

账单地址的邮编。[2...10]位

gender

String

是

性别。M-男；F-女

occupation

String

是

职业。取持卡人职业 occupationCode 参数

annualSalary

String

是

年薪。例：200000 USD

accountPurpose

String

是

帐户用途。例如：Living Expense

expectedMonthlyVolume

String

是

预期月交易量。100000 USD

idType

String

是

证件类型。 PASSPORT：护照 HK_HKID：香港身份证 DLN：DLN（只支持美国国籍） GOVERNMENT_ISSUED_ID_CARD：政府签发的身份证

idNumber

String

是

证件证号。[2...50]位

ssn

String

否

安全号码。如果签发国是美国，则需要 9 位数的 SSN

issueDate

String

是

id证件签发日期。yyyy-MM-dd

idNoExpiryDate

String

是

证件过期日期。yyyy-MM-dd

idFrontId

String

是

证件照正面照片文件ID。调用 上传文件接口 获取

idBackId

String

是

证件照背面照片文件ID。调用 上传文件接口 获取

idHoldId

String

是

手持证件照文件ID。调用 上传文件接口 获取

ipAddress

String

是

IPV4地址。

响应

参数

类型

是否必传

备注

holderId

Long

是

持卡人id

merchantOrderNo

String

是

商户订单号

cardTypeId

Long

是

卡片类型id

statusFlowLocation

String

是

审核流位置。只有当statusFlowLocation=admin且status=reject才支持更新持卡人 admin：平台审核； channel：银行审核

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": "审核通过"
    }
}

持卡人-创建-sumsub方式

受限制国家/地区消费者持卡人古巴；朝鲜；埃及；伊朗；缅甸；尼日利亚；俄罗斯；南非；叙利亚；乌克兰；委内瑞拉

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

请求

参数

类型

是否必传

备注

merchantOrderNo

String

是

商户订单号。[20...35]位

cardTypeId

Long

是

卡片类型ID

areaCode

String

是

手机区号。[2...5]位取支持的卡BIN接口参数 supportHolderAreaCode

mobile

String

是

手机号。[5...20]位

String

是

邮箱。需要接收验证码[5...50]位

firstName

String

是

名。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

lastName

String

是

姓。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

occupation

String

是

职业。取持卡人职业 occupationCode 参数

annualSalary

String

是

年薪。例：10000000 USD

accountPurpose

String

是

帐户用途。只支持英文，例如：Living Expense

expectedMonthlyVolume

String

是

预期月交易量。100000 USD

sumSubShareToken

String

是

sumsub share token

ipAddress

String

是

IPV4地址。

响应

参数

类型

是否必传

备注

holderId

Long

是

持卡人id

merchantOrderNo

String

是

商户订单号

cardTypeId

Long

是

卡片类型id

statusFlowLocation

String

是

审核流位置。只有当statusFlowLocation=admin且status=reject才支持更新持卡人 admin：平台审核； channel：银行审核

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,
        "statusFlowLocation": "admin",
        "status": "pass_audit",
        "statusStr": "审核通过",
        "respMsg": "SUCCESS"
    }
}

持卡人-更新-sumsub方式

只有当statusFlowLocation=admin且status=reject才支持更新持卡人

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

请求

参数

类型

是否必传

备注

holderId

Long

是

持卡人ID

areaCode

String

是

手机区号。[2...5]位取支持的卡BIN接口参数 supportHolderAreaCode

mobile

String

是

手机号。[5...20]位

String

是

邮箱。需要接收验证码[5...50]位

firstName

String

是

名。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

lastName

String

是

姓。只支持英文字符。[2...30]位。firstName和lastName总长度不能超过30字符（包括空格）

occupation

String

是

职业。取持卡人职业 occupationCode 参数

annualSalary

String

是

年薪。例：10000000 USD

accountPurpose

String

是

帐户用途。只支持英文，例如：Living Expense

expectedMonthlyVolume

String

是

预期月交易量。100000 USD

sumSubShareToken

String

是

sumsub share token

ipAddress

String

是

IPV4地址。

响应

参数

类型

是否必传

备注

holderId

Long

是

持卡人id

merchantOrderNo

String

是

商户订单号

cardTypeId

Long

是

卡片类型id

statusFlowLocation

String

是

审核流位置。只有当statusFlowLocation=admin且status=reject才支持更新持卡人 admin：平台审核； channel：银行审核

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]位

String

否

邮箱。[5...50]位

响应

参数

类型

是否必传

备注

holderId

Long

是

持卡人id

merchantOrderNo

String

否

商户订单号

cardTypeId

Long

是

卡片类型id

areaCode

String

是

手机区号。[2...5]位

mobile

String

是

手机号。[5...20]位

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]位

statusFlowLocation

String

是

审核流位置。 admin：平台审核； channel：银行审核

status

String

是

状态。 wait_audit: 待审核; pass_audit: 审核通过;

under_review: 审核中; reject: 拒绝

statusStr

String

是

状态描述

respMsg

String

否

备注

createTime

Long

是

创建时间。毫秒时间戳

updateTime

Long

是

更新时间。毫秒时间戳

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "total": 11,
        "records":
        [
            {
                "holderId": 102424,
                "merchantOrderNo": "24353647ksglsan3535",
                "cardTypeId": 102424,
                "areaCode": "+852",
                "mobile": "875692311",
                "email": "test@test.com",
                "firstName": "elly",
                "lastName": "tom",
                "birthday": "1990-10-10",
                "country": "HK",
                "countryStr": "香港",
                "town": "HK_KKC_1",
                "townStr": "九龙城区",
                "address": "To Kwa Wan, Kowloon, Hong Kong",
                "postCode": "999077",
                "statusFlowLocation": "admin",
                "status": "pass_audit",
                "statusStr": "审核通过",
                "respMsg": null,
                "createTime": 232413142131,
                "updateTime": 232413142131
            }
        ]
    }
}

Previous卡管理模块 Next通知订阅

Last updated 28 days ago