见证宝商户绑卡接口
接口说明
由于本系统特殊性,当服务商下的商户结算帐户需要绑定对公账户时需要单独调用该接口进行绑卡:本接口绑卡操作使用小额鉴权,鉴权的金额需要在“商户见证宝验证鉴权金额接口中”回传;本接口操作使用银联鉴权,鉴权的验证码需要在“银联鉴权短信接口”中回传。
若商户结算账户不需要绑定对公账户时该接口可不关注。
该接口同商户绑卡接口不得同时调用
如果绑对公的卡,请选择id_type在50位以后的信息传,对私的卡选择前20位
12月6日对私绑卡bank_card_user添加商户入驻时的id_card_name字段的校验,如不一样,则不允许绑卡
方法名
- fshows.liquidation.store.witness.bind.bank
请求地址
| 环境 | 请求地址 |
|---|---|
| 测试环境 | https://openapi-liquidation-test.51fubei.com/gateway |
| 正式环境 | https://openapi-liquidation.51fubei.com/gateway |
公共请求参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| app_id | string | 是 | 32 | 移动支付平台分配给接入平台的服务商唯一的 ID,请向 相应的对接负责人获取 |
| method | string | 是 | 128 | 接口名称 |
| sign | string | 是 | 256 | 请求参数的签名串 |
| version | string | 是 | 3 | 调用的接口版本,默认且固定为:1.0 |
| content | string | 是 | - | 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递 |
请求参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| lp_store_id | String | 是 | 20 | 清算平台商户号 |
| id_type | String | 是 | 2 | 证件类型:详情见下方'接口证件类型说明' |
| id_code | String | 是 | 20 | 证件号码 |
| bank_type | String | 是 | 1 | 银行类型:1-平安银行,2-其他银行 |
| bank_card_id | String | 是 | 32 | 提现的银行卡 |
| bank_card_user | String | 是 | 32 | 提现的银行卡开户名 |
| bank_name | String | 是 | 120 | 开户行名称 |
| bank_code | String | 是 | 14 | 大小额行号(每个开户行都有对应的大小额行号,具体获取方法参考附件中的压缩文件 大小额行号下载) |
| s_bank_code | String | 否 | 14 | 超级网银号(每个银行都有对应的超级网银号,具体请参考附件) 超级网银号下载 |
| mobile_phone | String | 是 | 12 | 手机号 |
| auth_type | String | 否 | 2 | 鉴权类型(默认为1):1-小额鉴权 2-银联鉴权 |
请求示例
{
"lp_store_id":"111111222",
"id_type":"1",
"id_code":"341021195609126666",
"bank_type":"1",
"bank_card_id":"62206677777777777",
"bank_card_user":"张凯",
"bank_name":"杭州市余杭区良渚支行",
"bank_code":"2222222",
"mobile_phone":"13566665555",
"auth_type":"1"
}
返回值示例 成功请求示例:
{
"return_value":{"msg":"商户见证宝绑卡成功"},
"success":true
}
失败请求示例
{
"error_code":"-101",
"error_message":"无效参数",
"success":false
}
接口证件类型说明
1-身份证
2-军人军官证
3-港澳台居民通行证
4-中国护照
8-武警警官证
9-临时身份证
11-户口簿
12-中国居民其他证
13-军人士兵证
14-军人文职干部证
15-军人其他证件
16-武警士兵证
17-武警文职干部证
18-武警其他证件
19-外国护照
20-外国公民其他证件
51-法人代码证
52-组织机构代码证
53-政府机构/公共机构批文
54-外交部外事办批文(使)
55-外交部外事办批文(领)
56-外交部外事办批文(办)
60-香港商业登记证
65-事业单位登记证
66-社会团体登记证
67-商业登记证(离岸)
68-营业执照
69-对公临时证件
70-其他证明文件(公司)
71-公司户重复有效证件
73-统一社会信用代码
80-金融机构