請求URL
測試環境：https://test.wsmsd.cn/sit/api/v3/ltbs/dsf/batch_ds_qry
生產環境：https://s2.lakala.com/api/v3/ltbs/dsf/batch_ds_qry
請求接口說明(req_data)
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|
| merchant_no | 商戶號 | 是 | String(32) | 拉卡拉數科提供
示例：4002024052370293947 |
| term_no | 終端號 | 否 | String(32) |
|
| enterprise_num | 企業編號 | 是 | String(10) | 拉卡拉數科提供 |
| corp_bank_code | 發起方銀行渠道代碼 | 是 | String(8) | 參見【銀行渠道代碼】 |
| req_seq_no | 批次號 | 是 | String(30) | 全局唯一,數字字母 |
響應(resp_data)
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|
| req_seq_no | 批次號 | 是 | String(8) | 全局唯一 |
| trans_state | 交易狀 | 否 | String(8) | 2：整批完成3:整批失敗4:提交成功，處理中 |
| total_num | 總筆數 | 否 | String(6) |
|
| total_amount | 總金額(元) | 否 | String(8) |
|
| pay_info_code | 交易信息碼 | 否 | String(8) |
|
| verify_code | 驗簽碼 | 否 | String(180) | 企業-驗簽字段(金額單位元，格式化成兩位小數#.##)：`enterprise_num`_`req_seq_no`;`pay_act`_`pay_amount`_`result`;`pay_act`_`pay_amount`_`result`…(企業編號_批次號;明細-客戶方賬戶_交易金額交易狀態;明細-客戶方賬戶\交易金額_交易狀態…);注：拼接的明細需按升序（字符串從小到大）的順序進行排序 |
| vch_id | 憑證編號 | 是 | String(8) |
|
| detail_record | 交易明細信息列表 | 否 | Object |
|
detail_record 字段說明
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|
| rec_act | 企業方賬戶 | 是 | String(32) |
|
| pay_name | 客戶方戶名 | 是 | String(60) |
|
| pay_act | 客戶方賬號 | 是 | String(32) |
|
| pay_amount | 交易金額 | 是 | String(18) | 單位分 |
| cur_type | 幣種 CNY | 否 | String(3) |
|
| usage | 用途 | 否 | String(64) |
|
| post_script_no | 流水號 | 是 | String(16) | 批次內唯一 |
| memo | 備注 | 是 | String(512) |
|
| req_reserve | 對賬碼 | 否 | String(32) |
|
| result | 交易狀態 | 是 | String(32) | 2成功 3失敗 |
| pay_info_code | 交易信息碼 | 是 | String(8) |
|
| is_private | 公私標記 | 否 | String(1) |
|
| accounting_date | 入賬日期 | 是 | String(8) | yyyyMMdd |
| org_code | 機構號 | 是 | String(16) |
|
| agreement_no | 銀行代收協議編號 | 否 | String(30) | 目前交行請求數據未填寫但是實際已簽約時返回 |
| source_note | 原始單據號 | 否 | String(100) |
|
請求示例
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "HN43000009023690002",
"corp_bank_code": "GJ101",
"req_seq_no": "ccbbds2024052800001"
}
}復制
響應示例
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"vch_id": "VS202404103911583970",
"trans_state": "2",
"total_amount": "3",
"total_num": "2",
"req_seq_no": "ccbbds2024052800001",
"pay_info_code": "",
"verify_code": "",
"detail_record": [{
"memo": "測試備注",
"pay_act": "6227002920120342761",
"pay_amount": "1",
"pay_info": "客戶可用余額小于等于部分扣款臨界值,部分扣款臨界值為1",
"pay_info_code": "3",
"pay_name": "敖八九",
"post_script_no": "1",
"rec_act": "43050179373600000471",
"result": "3",
"usage": "直連客戶代收專用"
},
{
"memo": "測試備注",
"pay_act": "4367422928030302997",
"pay_amount": "2",
"pay_info": "交易成功",
"pay_info_code": "2",
"pay_name": "丁四七",
"post_script_no": "2",
"rec_act": "43050179373600000471",
"result": "2",
"usage": "直連客戶代收專用"
}]
}
}復制
請求示例2
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "QT330001",
"corp_bank_code": "BR105",
"req_seq_no": "BATds302405280002"
}
}復制
響應示例2
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"vch_id": "",
"trans_state": "4",
"total_amount": "10.00",
"total_num": "2",
"req_seq_no": "BATds302405280002",
"pay_info_code": "I1000",
"verify_code": ""
}
}復制
錯誤碼
