拉卡拉API调用特约商户电子合同申请
提供与拉卡拉进行电子签约的第四方进行电子合同申请,电子合同签约成功后不需要将其下载出来作为附件上传,只需将电子合同编号(ecNo),在“新增商户入网”接口中在(contractNo)字段中传入即可。
合同类别适用业务场景说明:
| 合同类别编码 | 合同名称 | 适用场景 | 使用指南 |
|---|---|---|---|
| EC001 | 特约商户支付服务合作协议V3.1 | 商户入网 | 历史存量,推荐使用EC008 |
| EC002 | 特约商户支付服务合作协议V3.2+分账结算授权委托书 | 商户入网+分账业务 | 历史存量,推荐使用EC007 |
| EC003 | 分账结算授权委托书 | 分账 | 历史存量,推荐使用EC009 |
| EC004 | 特约商户支付服务合作协议V3.3 | 商户入网 | 历史存量,推荐使用EC008 |
| EC005 | 特约商户支付服务合作协议V3.3+分账结算授权委托书 | 商户入网+分账业务 | 历史存量,推荐使用EC007 |
| EC007 | 特约商户支付服务合作协议V4.1+分账结算授权委托书 | 商户入网+分账业务 | 当前最新版本 |
| EC008 | 特约商户支付服务合作协议V4.1 | 商户入网 | 当前最新版本 |
| EC009 | 清分结算授权委托书 | 分账业务 | 当前最新版本 |
| EC010 | 特约商户支付服务合作协议V4.1+清分结算授权委托书 | 商户入网+分账业务 | 当前最新版本(替换EC007) |
| EC011 | 清分结算授权委托书 | 分账业务 | 当前最新版本(替换EC009) |
请求URL
测试环境:https://test.wsmsd.cn/sit/api/v3/mms/open_api/ec/apply
生产环境:https://s2.lakala.com/api/v3/mms/open_api/ec/apply
请求参数
| 属性 | 说明 | 必选 | 类型 | 备注 |
|---|---|---|---|---|
| order_no | 四方机构自定义订单编号 | M | String(32) | 建议:平台编号+14位年月日时(24小时制)分秒+8位的随机数(同一接入机构不重复) |
| org_id | 机构号 | M | Integer | 签约方所属拉卡拉机构 |
| ec_type_code | 合同类别 | M | String(12) | EC001 : 特约商户支付服务合作协议V3.1(商户入网) EC002 : 特约商户支付服务合作协议V3.2(商户入网+分账) EC003 : 分账结算授权委托书 EC004 : 特约商户支付服务合作协议V3.3(商户入网) EC005 : 特约商户支付服务合作协议V3.3(商户入网+分账) EC007 : 特约商户支付服务合作协议V4.1 + 结算授权委托书 (商户入网 + 分账 ) EC008 : 特约商户支付服务合作协议V4.1 (商户入网) EC009 : 结算授权委托书 EC010 : 特约商户支付服务合作协议V4.1+清分结算授权委托书 EC011 : 清分结算授权委托书 |
| cert_type | 法人/经营者证件类型 | M | String(16) | RESIDENT_ID(身份证); PASSPORT(护照); HK_MACAO_PASS(港澳居民往来内地通行证); TAIWAN_PASS(台湾居民来往大陆通行证); |
| cert_name | 法人/经营者姓名 | M | String(32) | |
| cert_no | 法人/经营者证件号码 | M | String(32) | |
| mobile | 签约手机号 | M | String(16) | 1.小微个人商户(无营业执照),签约手机号必须填写商户经营者本人手机号;2.个体工商户或企业商户(有营业执照),签约手机号必须填写法人手机号或者经办人手机号 合同签署人手机号,请慎重填写,不可修改 |
| business_license_no | 营业执照号 | C | String(32) | 个体工商户或企业商户 必传 |
| business_license_name | 营业执照名称 | C | String(32) | 个体工商户或企业商户 必传 |
| openning_bank_code | 企业/经营者结算开户行号 | M | String(32) | |
| openning_bank_name | 企业/经营者结算开户行名称 | M | String(128) | |
| acct_type_code | 企业/经营者结算卡性质 | M | String(2) | 57 对公、 58 对私 |
| acct_no | 企业/经营者结算卡号 | M | String(32) | |
| acct_name | 企业/经营者结算卡名称 | M | String(64) | 企业/经营者结算卡名称 |
| ec_content_parameters | 电子合同内容参数集合 | M | JSONString | 按合同类型(ecTypeCode)传递不同的参数集合, |
| agent_tag | 是否经办签约 | C | Integer(1) | 0 不启用 1启用 ; 缺省 0 |
| agent_name | 经办人名称 | C | String(32) | 经办人名称(要与证件号对应)agentTag 为1时 必传 |
| agent_cert_type | 经办人证件类型 | C | String(32) | RESIDENT_ID(身份证); PASSPORT(护照); HK_MACAO_PASS(港澳居民往来内地通行证); TAIWAN_PASS(台湾居民来往大陆通行证); agentTag 为1时 必传 |
| agent_cert_no | 经办人证件号 | C | String(32) | agentTag 为1时 必传 |
| agent_file_name | 经办签约授权委托书文件名 | C | String(32) | agentTag 为1时 必传 |
| agent_file_path | 经办授权委托书文件路径 | C | String(128) | agentTag 为1时 必传 |
| remark | 备注说明 | C | String(128) | 备注说明 |
| ret_url | 电子合同签约结果回调通知 | C | String(128) | 成功签约才通知 |
响应参数
| 属性 | 说明 | 必选 | 类型 | 备注 |
|---|---|---|---|---|
| code | 返回码 | M | String(6) | 成功 000000 其它失败 |
| message | 返回码描述 | M | String(128) | 返回码描述成功 |
| data | 结果信息集合 | M | Object | |
| order_no | 请求上送的订单号 | M | String(32) | |
| ec_apply_id | 电子签约申请受理编号 | M | Long | |
| result_url | 电子签约申请结果H5链接地址(长度较长2000+) | M | String | 申请成功时:待签约合同H5链接 申请失败时:错误信息结果H5链接 |
请求报文
{
{
"req_data": {
"acct_name": "农建",
"acct_no": "6221884568549653222",
"acct_type_code": "57",
"business_license_name": "拉卡拉科技有限公司",
"business_license_no": "90000000MA1FPFRF44",
"cert_name": "徐文",
"cert_no": "431003198708066555",
"cert_type": "PASSPORT",
"ec_content_parameters": "{\"A65\":\"是\",\"B20\":\"6221884568549653222\",\"A67\":2023,\"A68\":5,\"A69\":5,\"B3\":\"是\",\"B24\":\"徐文\",\"B46\":\"是\",\"B25\":\"110106196508231851\",\"B47\":\"专业化扫码支付\",\"B26\":\"18504343826\",\"B27\":\"徐文\",\"B28\":\"yhws@psbc-ubank.com\",\"B29\":\"110106196508231851\",\"A1\":\"拉卡拉科技有限公司\",\"A70\":2023,\"A71\":5,\"A72\":5,\"A51\":\"0%\",\"A52\":\"0.01%\",\"B30\":\"18269443753\",\"B31\":\"拉卡拉科技有限公司\",\"B10\":\"拉卡拉科技有限公司\",\"B32\":\"朱有有\",\"B33\":\"上海市黄浦区新码头街\",\"B34\":\"18504343826\",\"A58\":\"2\",\"B13\":\"山东省临沂市\",\"A59\":\"是\",\"B14\":\"90000000MA1FPFRF44\",\"A19\":4.0,\"B18\":\"朱有有\",\"B19\":\"邮储银行联行行号\",\"D1\":\"2023/05/05\",\"B1\":2023,\"B2\":5,\"B8\":\"拉卡拉科技有限公司\",\"B9\":\"未列入其他代码的食品商店\",\"A61\":\"是\",\"A64\":\"邮惠万家银行\"}",
"ec_type_code": "EC004",
"mobile": "13813913988",
"openning_bank_code": "403100000004",
"openning_bank_name": "招商银行",
"order_no": "e0a1d6f8dbca4ee99dddf8a805778d37",
"org_id": 1,
"remark": "测试",
"version": "1.0"
}
}
}复制成功响应报文
{
"code": "000000",
"msg": "成功",
"resp_data": {
"order_no": "e0a1d6f8dbca4ee99dddf8a805778d37",
"ec_apply_id": 863797013367664640,
"result_url": "https://jrt.wsmsd.cn/signature/s/wl6392"
}
}复制异步签约结果通知消息(respData部分)
| 属性 | 说明 | 必选 | 类型 | 备注 |
|---|---|---|---|---|
| version | 版本号 | M | String(32) | 1.0 |
| orgId | 机构号 | M | Integer | 合同所属机构号 |
| orderNo | 请求上送的订单号 | M | String(32) | |
| ecApplyId | 电子签约申请受理编号 | M | Long | |
| ecNo | 电子合同号 | M | String(32) | QT20210914000216202 |
| ecName | 电子合同名称 | M | String(32) | 特约商户支付服务合作协议V3.1 |
| ecStatus | 电子合同签署状态 | M | String(32) | UNDONE 未完成 COMPLETED 已完成 |
异步通知报文
{
"ecApplyId": 635798487769907200,
"ecName": "特约商户支付服务合作协议V3.1",
"ecNo": "QT20221021000157861",
"ecStatus": "COMPLETED",
"orderNo": "177212022102111161183863984",
"orgId": 1,
"version": "1.0"
}复制错误码
| 错误码 | 描述 | 备注 |
|---|---|---|
| 000000 | 交易成功 | |
| 087900 | 三四要素认证失败 | 此状态下可申请转人工复核 |
| 087901 | 手机号实名认证不通过 |
The End
