銀直通單筆代付狀態查詢
請求URL
測試環境：https://test.wsmsd.cn/sit/api/v3/ltbs/dsf/df_qry
生產環境：https://s2.lakala.com/api/v3/ltbs/dsf/df_qry
請求接口說明(req_data)
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|---|---|---|---|
| merchant_no | 商戶號 | 是 | String(32) | 拉卡拉數科提供 示例：4002024052370293947 |
| term_no | 終端號 | 否 | String(32) | |
| enterprise_num | 企業編號 | 是 | String(10) | 拉卡拉數科提供 |
| corp_bank_code | 發起方銀行渠道代碼 | 是 | String(8) | 參見【銀行渠道代碼】 |
| trans_no | 16位流水號，永久唯一 | 是 | String(16) |
響應(resp_data)
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|---|---|---|---|
| trans_date | 交易日期 | 否 | String(8) | yyyyMMdd |
| verify_code | 驗簽碼 | 否 | String(180) | 驗簽碼，企業-簽名字段：(state為2和3時需要驗簽,金額單位元，格式化成兩位小數#.##)：`enterprise_num` _`trans_no`_`cust_acc_num`_`cust_acc_name`_`amount`_`state` (企業編號_流水號_客戶帳號_帳戶名稱_交易金額_支付狀態) |
| trans | 交易明細信息 | 否 | Object |
響應 trans字段說明
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|---|---|---|---|
| trans_no | 16位流水號，永久唯一 | 是 | String(16) | |
| protocol_code | 簽約扣款必填，簽約全局唯一協議號 | 是 | String(30) | |
| cust_bank_code | 客戶銀行編碼 | 否 | String(8) | |
| cust_acc_num | 客戶帳號 | 是 | String(32) | |
| cust_acc_name | 客戶帳戶名稱 | 否 | String(60) | |
| amount | 交易金額,單位分 | 是 | String(21) | |
| currency | 幣種 | 否 | String(3) | |
| cert_type | 證件類型 | 否 | String(1) | |
| cert_num | 證件號碼 | 否 | String(32) | |
| mobile | 手機號碼 | 否 | String(11) | |
| fg_trans_time | 交易時間 | 否 | String(20) | |
| fail_trans_accounting_flag | 交易失敗是否記賬 | 否 | String(1) | 付款有失敗結果時才有值 0 不記賬 默認 1記賬 |
| state | 支付狀態 | 是 | String(1) | 2交易成功 3交易失敗 4處理中 |
| info_code | 支付信息返回碼 | 否 | String(8) | |
| info | 支付信息返回詳細信息 | 否 | String(512) | |
| bank_extent1 | 銀行返回擴展1 | 否 | String(100) | |
| bank_extent2 | 銀行返回擴展2 | 否 | String(100) | |
| vch_id | 憑證編號 | 否 | String(64) |
請求示例
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "HN43000009023690002",
"corp_bank_code": "GJ101",
"trans_no": "ccbdf2024052800001"
}
}復制響應示例
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"trans_date": "20240528",
"verify_code": "",
"trans": {
"amount": "100",
"info": "委托項目編號：4302010809,實時單筆單據交易成功",
"state": "2",
"trans_no": "ccbdf2024052800001",
"vch_id": "VS202405289869846618"
}
}
}復制請求示例2
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "QT330001",
"corp_bank_code": "BR102",
"trans_no": "BRdf2024052820003"
}
}復制響應示例2
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"trans_date": "20240528",
"verify_code": "GN9OsgorSSGw0uW7xXLTccRjNJql81NZcrJUoMU2xoOWVJIwioDp3Q0ynG/iI6KTolkmm5mlRTabbkBX1sNxTBJa/9DDYswDWwL1g9Z+3F+PPA9AZtIY0dfoKV1KZfwh3pkAJE0aXm+Qm2pDBDI7FUWliO6J3J5tWXpI+S6Pt5w=",
"trans": {
"amount": "1000",
"bank_extent1": "20240528",
"cust_bank_code": "GJ101",
"fg_trans_time": "20240528204859",
"info": "S0000::支付成功::交易成功",
"info_code": "S0000",
"state": "2",
"trans_no": "BRdf2024052820003"
}
}
}復制錯誤碼
| 錯誤碼 | 描述 | 備注 |
|---|---|---|
| 000000 | 成功 | - |
| 其他 | 失敗 | - |
The End