銀直通批量代付
請求URL
測試環(huán)境：https://test.wsmsd.cn/sit/api/v3/ltbs/dsf/batch_df
生產環(huán)境：https://s2.lakala.com/api/v3/ltbs/dsf/batch_df
請求接口說明(req_data)
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|---|---|---|---|
| merchant_no | 商戶號 | 是 | String(32) | 拉卡拉數(shù)科提供 示例：4002024052370293947 |
| term_no | 終端號 | 否 | String(32) | |
| enterprise_num | 企業(yè)編號 | 是 | String(10) | 拉卡拉數(shù)科提供 |
| corp_bank_code | 發(fā)起方銀行渠道代碼 | 是 | String(8) | 參見【銀行渠道代碼】 |
| verify_code | 驗簽碼 | 否 | String(180) | 企業(yè)-驗簽字段(金額單位元，格式化成兩位小數(shù)#.##)：`enterprise_num`_`req_seq_no`;`rec_act`_`pay_amount`;`rec_act`_`pay_amount`…(企業(yè)編號_批次號;明細-客戶方賬戶_交易金額;明細-客戶方賬戶_交易金額…);注：拼接的明細需按升序（字符串從小到大）的順序進行排序 |
| total_num | 總筆數(shù) | 是 | String(6) | |
| total_amt | 總金額，分為單位 | 是 | String(18) | |
| req_seq_no | 批次號,全局唯一,數(shù)字字母 | 是 | String(30) | |
| accounting_flag | 記賬標記 | 否 | String(1) | 記賬標記 1：單筆記賬 2：按批記 3：匯總記賬 |
| trans_param | 交易明細信息 | 是 | Object |
trans_param字段說明
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|---|---|---|---|
| pay_act | 企業(yè)方賬號 | 是 | String(32) | |
| pay_area | 企業(yè)方區(qū)域代碼 | 否 | String(8) | |
| pay_area_name | 企業(yè)方區(qū)域名稱 | 否 | String(60) | |
| corp_bank_code | 企業(yè)方銀行代碼 | 是 | String(8) | |
| detail_record | 交易信息列表 | 是 | Object | 具體交易信息可多個 |
detail_record 字段說明
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|---|---|---|---|
| pay_name | 企業(yè)方戶名 | 否 | String(60) | |
| pay_act | 企業(yè)方賬號 | 是 | String(32) | |
| pay_bnk | 企業(yè)方銀行開戶行名 | 否 | String(64) | |
| pay_area | 企業(yè)方區(qū)域代碼 | 否 | String(8) | |
| pay_bank_code | 企業(yè)方銀行代碼 | 是 | String(8) | |
| pay_bank_name | 企業(yè)方銀行名稱 | 否 | String(64) | |
| pay_area_name | 企業(yè)方區(qū)域名稱 | 否 | String(60) | |
| rec_name | 客戶方戶名 | 是 | String(60) | |
| rec_act | 客戶方賬戶 | 是 | String(32) | |
| rec_bnk | 客戶方銀行開戶行名 | 否 | String(64) | |
| rec_bank_code | 客戶方銀行代碼 | 是 | String(8) | |
| rec_bank_name | 客戶方銀行名稱 | 否 | String(64) | |
| rec_area | 客戶方區(qū)域代碼 | 是 | String(8) | |
| rec_area_name | 客戶方區(qū)域名稱 | 否 | String(60) | |
| card_type | 卡折標記0卡;1折 | 是 | String(1) | |
| same_city | 是否同城1：同城 | 否 | String(1) | |
| same_bnk | 是否同行1：同行 | 否 | String(1) | |
| pay_date | 交易日期 yyyyMMdd | 否 | String(8) | |
| pay_time | 交易時間 HHmmss | 否 | String(6) | |
| pay_amount | 交易金額，單位分 | 是 | String(18) | |
| pay_cur | 企業(yè)方幣種 CNY | 否 | String(3) | |
| rec_cur | 客戶方幣種 CNY | 是 | String(3) | |
| cert_type | 證件類型，銀聯(lián)跨行收必填 | 否 | String(1) | 僅支持“0：身份證”類型 |
| cert_num | 證件號，銀聯(lián)跨行收必填 簽約扣款必填 | 否 | String(32) | |
| credit_card_sec_code | 信用卡驗證碼 銀聯(lián)標準卡稱為CVN2，萬事達卡稱為CVC2，VISA卡稱為CVV2，AE運通卡則稱為CSC2 | 否 | String(100) | |
| credit_card_validity | 信用卡有效期 | 否 | String(32) | |
| usage | 用途 | 否 | String(64) | |
| post_script_no | 流水號，批次內唯一 | 是 | String(16) | |
| memo | 備注 | 否 | String(512) | |
| req_reserve | 對賬碼 | 否 | String(32) | |
| cnaps_code | 聯(lián)行號 | 否 | String(12) | |
| cnaps_name | 開戶行名稱 跨行時為提高支付成功率請準確填寫 | 否 | String(64) | |
| is_private | 公私標記 | 否 | String(1) | |
| org_code | 機構號 | 否 | String(16) | |
| source_note | 原始單據(jù)號 | 否 | String(100) | |
| extent1 | 預留擴展1 | 否 | String(64) | |
| extent2 | 預留擴展2 | 否 | String(64) |
響應(resp_data)
| 字段名稱 | 內容 | 是否必輸 | 最大長度 | 備注 |
|---|---|---|---|---|
| req_seq_no | 批次號,全局唯一 | 否 | String(8) | |
| trans_state | 交易狀態(tài)3:整批失敗4:提交成功，處理中 | 否 | String(8) | |
| pay_info_code | 批次號,全局唯一 | 否 | String(8) | |
| verify_code | 驗簽碼 | 否 | String(180) | 簽碼，企業(yè)-驗簽字段：`enterprise_num`_`req_seq_no`_`trans_state`(企業(yè)編號_流水號_交易狀態(tài)) 注：僅“3-整批失敗”時需要簽名驗簽 |
| vch_id | 憑證編號 | 否 | String(8) |
請求示例
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "HN43000009023690002",
"corp_bank_code": "GJ101",
"total_num": "2",
"total_amt": "2",
"req_seq_no": "ccbbdf2024052800001",
"trans_param": {
"pay_act": "43050179373600000471",
"corp_bank_code": "GJ101",
"detail_record": [{
"rec_name": "敖八九",
"rec_act": "6227002920120342761",
"rec_bank_code": "GJ101",
"rec_area": "110100",
"pay_act": "43050179373600000471",
"pay_bank_code": "GJ101",
"pay_amount": "1",
"rec_cur": "CNY",
"post_script_no": "1",
"usage": "測試摘要",
"memo": "測試備注",
"card_type": "0"
},
{
"rec_name": "丁四七",
"rec_act": "4367422928030302997",
"rec_bank_code": "GJ101",
"rec_area": "110100",
"pay_act": "43050179373600000471",
"pay_bank_code": "GJ101",
"pay_amount": "1",
"rec_cur": "CNY",
"post_script_no": "2",
"usage": "測試摘要",
"memo": "測試備注",
"card_type": "0"
}]
}
}
}復制響應示例
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"vch_id": "VS202405283575601902",
"trans_state": "4",
"req_seq_no": "ccbbdf2024052800001",
"pay_info_code": "",
"verify_code": ""
}
}復制請求示例2
{
"version": "3.0",
"req_time": "20240528174343",
"req_id": "202405281743435",
"req_data": {
"merchant_no": "4002024052370293947",
"enterprise_num": "QT330001",
"corp_bank_code": "BR102",
"verify_code": "YDmV1rBjvZfs6xl7iE4vwu4JF7vwmId7AtGGyYBtgrrvc8UBKpJnYHQEFXq0y5FiBOEAW/wdP+3nSUNegfY9yBxnkxViHoQcIU0qc7yu/uwHi+Qq6Z6mRJZm0i8FA7+df6npMMdVYe9S63XwymkcIZlg1wRNAiz8iJSmmP4bHdE=",
"total_num": "2",
"total_amt": "1000",
"req_seq_no": "BRbatdf2024052800001",
"trans_param": {
"pay_act": "102330101",
"corp_bank_code": "BR102",
"detail_record": [{
"pay_act": "102330101",
"pay_bank_code": "BR102",
"rec_name": "測試",
"rec_act": "6174200081238968071",
"rec_bank_code": "BR102",
"rec_area": "110100",
"card_type": "0",
"pay_amount": "700",
"rec_cur": "CNY",
"post_script_no": "1"
},
{
"pay_act": "102330101",
"pay_bank_code": "BR102",
"rec_name": "測試",
"rec_act": "617420100037139511",
"rec_bank_code": "BR102",
"rec_area": "110100",
"card_type": "0",
"pay_amount": "300",
"rec_cur": "CNY",
"post_script_no": "2"
}]
}
}
}復制響應示例2
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"vch_id": "",
"trans_state": "4",
"req_seq_no": "BRbatdf2024052800001",
"pay_info_code": "I1000",
"verify_code": "YDmV1rBjvZfs6xl7iE4vwu4JF7vwmId7AtGGyYBtgrrvc8UBKpJnYHQEFXq0y5FiBOEAW/wdP+3nSUNegfY9yBxnkxViHoQcIU0qc7yu/uwHi+Qq6Z6mRJZm0i8FA7+df6npMMdVYe9S63XwymkcIZlg1wRNAiz8iJSmmP4bHdE="
}
}復制錯誤碼
| 錯誤碼 | 描述 | 備注 |
|---|---|---|
| 000000 | 成功 | - |
| 其他 | 失敗 | - |
The End