拉卡拉API調用特約商戶電子合同申請

lakala 3個月前 ( 11-20 ) 142

提供與拉卡拉進行電子簽約的第四方進行電子合同申請,電子合同簽約成功后不需要將其下載出來作為附件上傳,只需將電子合同編號(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