请求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": ""
}
}复制
错误码
