4.3【个人会员实名及绑卡】接口


测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle

生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle

接口代码(transCode):1010

功能说明:

支持通过此接口完成会员注册、实名及绑卡,即可开通待结算户;

(1)个人会员仅上送实名信息:

-身份证证件类型:姓名+身份证件号:统一认证身份证认证渠道,认证通过,完成实名。

-非身份证类型,接口响应:“不支持此证件类型”。可通过运营流程线下人工添加实名。

(2)个人会员上送实名信息及银行卡信息:

-身份证证件类型:姓名+身份证号+银行卡号+预留手机号:统一认证银行卡四要素认证渠道认证通过,完成实名及绑卡;

    1. 针对已实名认证的个人会员,支持通过此接口补充绑定银行卡,银行卡户名需与已实名信息一致。

处理逻辑:

(1)已实名个人会员进行再次实名,则提示“会员已实名!”

(2)个人会员:未实名,支持实名+绑定同名卡。

(3)个人会员:已实名,支持新增绑定同名卡,可支持绑定多张卡。

(3)企业会员(个体工商户):已实名,请求绑法人卡,仅支持绑定一张法人卡。


         
 测试环境统一验证结果模拟规则如下:
{"卡号第四位为0","交易成功"},
{"卡号第四位为1","查开户方原因"},
{"卡号第四位为2","无效卡号 "},
{"卡号第四位为3","已挂失卡"},
{"卡号第四位为4","余额不足"},
{"卡号第四位为5","无此账户"},
{"卡号第四位为6","原交易失败,不收费"},
{"卡号第四位为7","户名错"},
{"卡号第四位为8","交易超时"}

 

 

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

请求流水号

 

signNum

String

60

商户会员编号

 

memberRole

String

60

会员角色

  1. 未注册时必须上送角色
  2. 已注册时,无需上送

name

String

32

姓名

说明:

企业法人名称、个人姓名

cerType

String

2

证件类型

见枚举值,支持多种证件类型

注:绑卡方式8仅支持身份证

cerNum

String

32

证件号码

SM4加密

SM4加密。

详细

acctNum

String

32

银行卡号

SM4加密

详细

若绑卡,则银行卡四要素信息字段必须均上送。

phone

String

11

银行预留手机

bindType

String

1

绑卡方式

8-银行卡四要素验证

validDate

String

4

有效期,格式为月年;如0321,2位月2位年

说明:针对信用卡,若商户送,则透传渠道

cvv2

String

3

CVV2,3位数字

说明:针对信用卡,若商户送,则透传渠道

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

respTraceNum

String

40

响应流水号

业务正常处理,则返回

signNum

String

60

商户会员编号

 

respCode

String

5

业务返回码

00000:代表成功

66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。

其他返回码:均代表失败

respMsg

String

200

业务返回说明

 

maxy2 2025年3月27日 11:54 收藏文档