拉卡拉API调用特约商户电子合同申请

lakala 5天前 ( 11-20 19:44 ) 24

提供与拉卡拉进行电子签约的第四方进行电子合同申请,电子合同签约成功后不需要将其下载出来作为附件上传,只需将电子合同编号(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四方机构自定义订单编号MString(32)建议:平台编号+14位年月日时(24小时制)分秒+8位的随机数(同一接入机构不重复)
org_id机构号MInteger签约方所属拉卡拉机构
ec_type_code合同类别MString(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法人/经营者证件类型MString(16)RESIDENT_ID(身份证);
PASSPORT(护照);
HK_MACAO_PASS(港澳居民往来内地通行证);
TAIWAN_PASS(台湾居民来往大陆通行证);
cert_name法人/经营者姓名MString(32)
cert_no法人/经营者证件号码MString(32)
mobile签约手机号MString(16)1.小微个人商户(无营业执照),签约手机号必须填写商户经营者本人手机号;2.个体工商户或企业商户(有营业执照),签约手机号必须填写法人手机号或者经办人手机号 合同签署人手机号,请慎重填写,不可修改
business_license_no营业执照号CString(32)个体工商户或企业商户 必传
business_license_name营业执照名称CString(32)个体工商户或企业商户 必传
openning_bank_code企业/经营者结算开户行号MString(32)
openning_bank_name企业/经营者结算开户行名称MString(128)
acct_type_code企业/经营者结算卡性质MString(2)57 对公、 58 对私
acct_no企业/经营者结算卡号MString(32)
acct_name企业/经营者结算卡名称MString(64)企业/经营者结算卡名称
ec_content_parameters电子合同内容参数集合MJSONString按合同类型(ecTypeCode)传递不同的参数集合,

agent_tag是否经办签约CInteger(1)0 不启用 1启用 ; 缺省 0
agent_name经办人名称CString(32)经办人名称(要与证件号对应)agentTag 为1时 必传
agent_cert_type经办人证件类型CString(32)RESIDENT_ID(身份证);
PASSPORT(护照);
HK_MACAO_PASS(港澳居民往来内地通行证);

TAIWAN_PASS(台湾居民来往大陆通行证);

agentTag 为1时 必传

agent_cert_no经办人证件号CString(32)agentTag 为1时 必传
agent_file_name经办签约授权委托书文件名CString(32)agentTag 为1时 必传
agent_file_path经办授权委托书文件路径CString(128)agentTag 为1时 必传
remark备注说明CString(128)备注说明
ret_url电子合同签约结果回调通知CString(128)成功签约才通知

响应参数

属性说明必选类型备注
code返回码MString(6)成功 000000 其它失败
message返回码描述MString(128)返回码描述成功
      data结果信息集合MObject
      order_no请求上送的订单号MString(32)
 ec_apply_id电子签约申请受理编号MLong
      result_url电子签约申请结果H5链接地址(长度较长2000+)MString申请成功时:待签约合同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版本号MString(32)1.0
orgId机构号MInteger合同所属机构号
orderNo请求上送的订单号MString(32)
ecApplyId电子签约申请受理编号MLong
ecNo电子合同号MString(32)QT20210914000216202
ecName电子合同名称MString(32)特约商户支付服务合作协议V3.1
ecStatus电子合同签署状态MString(32)UNDONE 未完成
COMPLETED 已完成

异步通知报文

{
    "ecApplyId": 635798487769907200,
    "ecName": "特约商户支付服务合作协议V3.1",
    "ecNo": "QT20221021000157861",
    "ecStatus": "COMPLETED",
    "orderNo": "177212022102111161183863984",
    "orgId": 1,
    "version": "1.0"
}复制

错误码

错误码描述备注
000000交易成功
087900三四要素认证失败此状态下可申请转人工复核
087901手机号实名认证不通过
The End