银直通签约解约
请求URL
测试环境：https://test.wsmsd.cn/sit/api/v3/ltbs/dsf/sign
生产环境：https://s2.lakala.com/api/v3/ltbs/dsf/sign
请求接口说明(req_data)
| 字段名称 | 内容 | 是否必输 | 最大长度 | 备注 |
|---|---|---|---|---|
| merchant_no | 商户号 | 是 | String(32) | 拉卡拉数科提供 示例：4002024052370293947 |
| term_no | 终端号 | 否 | String(32) | |
| enterprise_num | 企业编号 | 是 | String(10) | 拉卡拉数科提供 |
| corp_bank_code | 发起方银行渠道代码 | 是 | String(8) | 参见【银行渠道代码】 |
| verify_code | 验签码 | 否 | String(180) | 企业-验签字段：`enterprise_num` _`protocol_code`_`cust_act`_`cert_num`_`mobile` (企业编号\企业签约协议号\客户方账号\证件号码_手机号) |
| sign_flag | 签约解约标记 | 是 | String(1) | 签约解约标记 0:签约 1:解约 |
| cust_act | 客户方账号 | 是 | String(32) | |
| cust_name | 客户方户名 | 是 | String(64) | |
| cert_num | 证件号码 | 是 | String(32) | |
| cert_type | 证件类型 | 是 | String(1) | 仅支持“0：身份证”类型 |
| mobile | 手机号 | 是 | String(11) | |
| corp_act | 企业方账号 | 是 | String(32) | |
| protocol_code | 企业签约协议号 | 是 | String(30) | |
| limit_amount | 单笔限额,单位分 | 否 | String(18) | 默认 9999900 |
响应(resp_data)
| 字段名称 | 内容 | 是否必输 | 备注 |
|---|---|---|---|
| sign_flag | 签约解约标记 | 是 | 0:签约 1:解约 |
| cust_act | 客户方账号 | 是 | |
| cust_name | 客户方户名 | 否 | |
| cert_num | 证件号 | 否 | |
| mobile | 手机号 | 否 | |
| limit_amount | 单笔限额 | 否 | |
| result_state | 返回状态 | 是 | 返回状态 5：已签约成功，重复签约 4：发起请求成功,等待验证 3：失败，具体信息看result_info 2：签约/解约成功 |
| result_info_code | 交易返回码 | 否 | |
| result_info | 签约返回信息 | 否 | |
| verify_code | 验签码 | 否 | 企业-验签字段：、`enterprise_num`_`protocol_code`_`cust_act`_`cert_num`_`mobile`_`result_state` |
请求示例
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "HN43000009023690002",
"corp_bank_code": "GJ101",
"sign_flag": "0",
"cust_act": "6227002920120342761",
"cust_name": "敖八九",
"cert_num": "230822198001013111",
"cert_type": "0",
"mobile": "17376105199",
"corp_act": "43050179373600000471",
"protocol_code": "2024052600001"
}
}复制响应示例
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"result_info_code": "",
"sign_flag": "0",
"limit_amount": "50000000",
"result_info": "",
"mobile": "17376105199",
"cert_num": "230822198001013111",
"cust_name": "敖八九",
"verify_code": "",
"cust_act": "6227002920120342761",
"result_state": "4"
}
}复制请求示例2
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "QT330001",
"corp_bank_code": "BR105",
"verify_code": "bjiwqO0XAlPXQUyuiVPbntll9Ix+7mKeSPaVypyOAEzAU1KWj1iRSFvXiOJIeE6VyfTs1YaIks/xNqbGMb09a+OCdpUxNPolY4asqxryrnrJd8VRX2w/Jaipyg4cHbmwhlTBJ+ApwbFwgJoF4NVMmDbxoA95bVD6HEg9YVnYR5A=",
"sign_flag": "0",
"cust_act": "6217001540000547001",
"cust_name": "小红",
"cert_type": "0",
"cert_num": "432930198009217013",
"mobile": "13800138000",
"corp_act": "105330102",
"protocol_code": "2024052800003",
"limit_amount": "500000"
}
}复制响应示例2
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"result_info_code": "I10001",
"sign_flag": "0",
"limit_amount": "",
"result_info": "短信发送成功，等待客户短信确认签约",
"mobile": "13800138000",
"cert_num": "432930198009217013",
"cust_name": "小红",
"verify_code": "I6+H5k6zTcZBau+xBeZNXs43p6K96pEKSfKa9rrftjsgR+RiMZ5UKTOoFhi0/ok3Gbb1RZsqCW+UqRUZT8fxMC/gK3jPTnzh65Hcbl/hkxBnvN7dHJHgtoSfH6VOKKHqCkrQN8TtCkAXmE6X9rsCJfGfFMP/xeIj/wYdsuICjvA=",
"cust_act": "6217001540000547001",
"result_state": "4"
}
}复制错误码
| 错误码 | 描述 | 备注 |
|---|---|---|
| 000000 | 成功 | - |
| 其他 | 失败 | - |
The End