电子合同接口.md 37 KB
电子合同申请
更新时间：2026-03-16 17:30:14作者：wangyuwei
提供与拉卡拉进行电子签约的第四方进行电子合同申请,电子合同签约成功后不需要将其下载出来作为附件上传，只需将电子合同编号（ecNo），在“新增商户入网”接口中在（contractNo）字段中传入即可。
合同类别适用业务场景说明：
| 合同类别编码 | 合同名称 | 适用场景 | 使用指南 |
|---|---|---|---|
| EC001 | 特约商户支付服务合作协议V3.1 | 商户入网 | 历史存量，即将下架 |
| EC002 | 特约商户支付服务合作协议V3.2+分账结算授权委托书 | 商户入网+分账业务 | 历史存量，即将下架 |
| EC003 | 分账结算授权委托书 | 分账 | 历史存量，即将下架 |
| EC004 | 特约商户支付服务合作协议V3.3 | 商户入网 | 历史存量，即将下架 |
| EC005 | 特约商户支付服务合作协议V3.3+分账结算授权委托书 | 商户入网+分账业务 | 历史存量，即将下架 |
| EC007 | 特约商户支付服务合作协议V4.1+分账结算授权委托书 | 商户入网+分账业务 | 历史存量，推荐使用EC010 |
| EC008 | 特约商户支付服务合作协议V4.1 | 商户入网 | 历史存量，推荐使用EC015 |
| EC009 | 清分结算授权委托书 | 分账业务 | 历史存量，推荐使用EC011 |
| EC010 | 特约商户支付服务合作协议V4.1+清分结算授权委托书 | 商户入网+分账业务 | 当前最新版本 |
| EC011 | 清分结算授权委托书 | 分账业务 | 当前最新版本 |
| EC013 | 清分结算授权委托书+增值服务合作协议 | 分账业务+分账计费 | 当前最新版本 |
| EC014 | 增值服务合作协议 | 分账计费 | 当前最新版本 |
| EC015 | 特约商户支付服务合作协议V4.2 | 商户入网 | 当前最新版本 |
请求URL
测试环境：https://test.wsmsd.cn/sit/api/v3/mms/open_api/ec/apply
生产环境：https://s2.lakala.com/api/v3/mms/open_api/ec/apply[](https://s2.lakala.com/api/v2/mms/openApi/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 : 清分结算授权委托书 EC013：清分结算授权委托书+增值服务合作协议（分账+分账计费） EC014：增值服务合作协议（分账计费） EC015：特约商户支付服务合作协议V4.2（商户入网） |
| 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）传递不同的参数集合， - EC001合同参数说明 - EC002合同参数说明 - EC003合同参数说明 - EC004合同参数说明 - EC005合同参数说明 - EC007合同参数说明 - EC008合同参数说明 - EC009合同参数说明 - EC010合同参数说明 - EC011合同参数说明 - EC013合同参数说明 - EC014合同参数说明 - [[EC015合同参数说明]] |
| 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": "e0a1d6f8db",
"org_id": 1,
"remark": "测试",
"version": "1.0"
}
}
成功响应报文
{
"code": "000000",
"msg": "成功",
"resp_data": {
"order_no": "e0a1d6f8db",
"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 | 手机号实名认证不通过 |