拉卡拉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
