銀直通簽約短信授權(quán)
請(qǐng)求URL
測(cè)試環(huán)境：https://test.wsmsd.cn/sit/api/v3/ltbs/dsf/sms_agent
生產(chǎn)環(huán)境：https://s2.lakala.com/api/v3/ltbs/dsf/sms_agent
請(qǐng)求接口說明(req_data)
| 字段名稱 | 內(nèi)容 | 是否必輸 | 最大長(zhǎng)度 | 備注 |
|---|---|---|---|---|
| merchant_no | 商戶號(hào) | 是 | String(32) | 拉卡拉數(shù)科提供 示例：4002024052370293947 |
| term_no | 終端號(hào) | 否 | String(32) | |
| enterprise_num | 企業(yè)編號(hào) | 是 | String(10) | 拉卡拉數(shù)科提供 |
| corp_bank_code | 發(fā)起方銀行渠道代碼 | 是 | String(8) | 參見【銀行渠道代碼】 |
| verify_code | 驗(yàn)簽碼 | 否 | String(180) | 企業(yè)-驗(yàn)簽字段：`enterprise_num` _`protocol_code`_`cust_act`_`cert_num`_`mobile`_`cert_code` (企業(yè)編號(hào)\企業(yè)簽約協(xié)議號(hào)\客戶方賬號(hào)\證件號(hào)碼_手機(jī)號(hào)\短信驗(yàn)證碼) |
| sign_flag | 簽約解約標(biāo)記 | 是 | String(1) | 簽約解約標(biāo)記 0:簽約 1:解約 |
| cust_act | 客戶方賬號(hào) | 是 | String(32) | |
| cust_name | 客戶方戶名 | 是 | String(64) | |
| cert_num | 證件號(hào)碼 | 是 | String(32) | |
| cert_type | 證件類型 | 是 | String(1) | 僅支持“0：身份證”類型 |
| mobile | 手機(jī)號(hào) | 是 | String(11) | |
| cert_code | 短信驗(yàn)證碼 | 是 | String(6) | |
| corp_act | 企業(yè)方賬號(hào) | 是 | String(32) | |
| protocol_code | 企業(yè)簽約協(xié)議號(hào) | 是 | String(30) | |
| limit_amount | 單筆限額 | 否 | String(18) | 默認(rèn) 99999.00 |
響應(yīng)(resp_data)
| 字段名稱 | 內(nèi)容 | 是否必輸 | 備注 |
|---|---|---|---|
| result_state | 返回狀態(tài) | 是 | 返回狀態(tài) 5：已簽約成功，重復(fù)簽約 4：發(fā)起請(qǐng)求成功,等待驗(yàn)證 3：失敗，具體信息看result_info 2：簽約/解約成功 |
| result_info_code | 交易返回碼 | 否 | |
| result_info | 簽約返回信息 | 否 | |
| agreement_no | 銀行代收協(xié)議編號(hào) | 否 | |
| verify_code | 驗(yàn)簽碼 | 否 | 企業(yè)-驗(yàn)簽字段：、`enterprise_num`_`protocol_code`_`cust_act`_`cert_num`_`mobile`_`result_state` |
請(qǐng)求示例
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "HN43000009023690002",
"corp_bank_code": "GJ101",
"sign_flag": "0",
"cust_act": "6227002920120342761",
"cust_name": "敖八九",
"cert_num": "230822198001013111",
"cert_type": "0",
"mobile": "17376105199",
"protocol_code": "2024052600001",
"corp_act": "43050179373600000471",
"cert_code": "846153"
}
}復(fù)制響應(yīng)示例
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"result_info_code": "",
"result_info": "",
"verify_code": "",
"result_state": "2"
}
}復(fù)制請(qǐng)求示例2
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "QT330001",
"corp_bank_code": "BR105",
"verify_code": "YqEqT9eSiEh67Rj9IteYsC14hTPux1GhF4W/MqBCqGkpSFPLP9kv+72tNm3+eHlk5uto585g/1Nl/ySVIEKyny5prv6xaNfiYqZ6y3RoiH1YTrK8SPpHIT5XaEgEdrPhxpFwKgiiRBC+DGKupZhRyLFkMaucTnIx2hI0ZPBcV8A=",
"sign_flag": "0",
"cust_act": "6217001540000547001",
"cust_name": "小紅",
"cert_type": "0",
"cert_num": "432930198009217013",
"mobile": "13800138000",
"corp_act": "105330102",
"protocol_code": "2024052800003",
"limit_amount": "500000",
"cert_code": "111111"
}
}復(fù)制響應(yīng)示例2
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"result_info_code": "S0000",
"result_info": "簽約成功",
"verify_code": "ZxZnmkkrfMzsoFiYTDOaHKhzA4skLJoztDKLygd0C9W5YUPOUgvfbXYrc86KcvDyHFTkSl0RQWEAe4bQZH3dY3IZN2qY0TEaG4nJnS9vP2YEkKHLi40HJ2fg2Qlq15rzYJ5oKFcpSizVcsMVC0bFXUfSsdoBEhTUd/ScxU4Jiog=",
"result_state": "2"
}
}復(fù)制錯(cuò)誤碼
| 錯(cuò)誤碼 | 描述 | 備注 |
|---|---|---|
| 000000 | 成功 | - |
| 其他 | 失敗 | - |
The End