銀直通批量代收

好拓客 5個(gè)月前 ( 11-25 ) 424

請(qǐng)求URL

測(cè)試環(huán)境：https://test.wsmsd.cn/sit/api/v3/ltbs/dsf/batch_ds
生產(chǎn)環(huán)境：https://s2.lakala.com/api/v3/ltbs/dsf/batch_ds


請(qǐng)求接口說明(req_data)

字段名稱內(nèi)容是否必輸最大長度備注
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)簽字段(金額單位元，格式化成兩位小數(shù)#.##)：`enterprise_num`_`req_seq_no`;`rec_act`_`pay_amount`;`rec_act`_`pay_amount`…(企業(yè)編號(hào)_批次號(hào);明細(xì)-客戶方賬戶_交易金額;明細(xì)-客戶方賬戶_交易金額…);注：拼接的明細(xì)需按升序（字符串從小到大）的順序進(jìn)行排序
total_num總筆數(shù)是String(6)
total_amt總金額，分為單位是String(18)
req_seq_no批次號(hào),全局唯一,數(shù)字字母是String(30)
accounting_flag記賬標(biāo)記否String(1)記賬標(biāo)記
1：?jiǎn)喂P記賬
2：按批記
3：匯總記賬
trans_param交易明細(xì)信息是Object

trans_param字段說明

字段名稱內(nèi)容是否必輸最大長度備注
rec_act企業(yè)方賬號(hào)是String(32)
rec_area企業(yè)方區(qū)域代碼否String(8)
rec_area_name企業(yè)方區(qū)域名稱否String(60)
corp_bank_code企業(yè)方銀行代碼是String(8)
detail_record交易信息列表是Object具體交易信息可多個(gè)

detail_record 字段說明

字段名稱內(nèi)容是否必輸最大長度備注
pay_name客戶方戶名是String(60)
pay_act客戶方賬號(hào)是String(32)
pay_bnk客戶方銀行開戶行名否String(64)
pay_area客戶方區(qū)域代碼是String(8)
pay_bank_code客戶方銀行代碼是String(8)
pay_bank_name客戶方銀行名稱否String(64)
pay_area_name客戶方區(qū)域名稱否String(60)
rec_name企業(yè)方戶名否String(60)
rec_act企業(yè)方賬戶是String(32)
rec_bnk企業(yè)方銀行開戶行名否String(64)
rec_bank_code企業(yè)方銀行代碼是String(8)
rec_bank_name企業(yè)方銀行名稱否String(64)
rec_area企業(yè)方區(qū)域代碼否String(8)
rec_area_name企業(yè)方區(qū)域名稱否String(60)
card_type卡折標(biāo)記是String(1)0：卡 1：折
same_city是否同城否String(1)1：同城
same_bnk是否同行否String(1)1：同行
pay_date交易日期否String(8)yyyyMMdd
pay_time交易時(shí)間否String(6)HHmmss
pay_amount交易金額是String(18)單位分
pay_cur客戶方幣種是String(3)CNY：人民幣
rec_cur企業(yè)方幣種否String(3)CNY：人民幣
cert_type證件類型否String(1)0：身份證
cert_num證件號(hào)否String(32)簽約扣款必填
credit_card_sec_code信用卡驗(yàn)證碼否String(100)銀聯(lián)標(biāo)準(zhǔn)卡稱為CVN2，萬事達(dá)卡稱為CVC2，VISA卡稱為CVV2，AE運(yùn)通卡則稱為CSC2
credit_card_validity信用卡有效期否String(32)
usage用途否String(64)
post_script_no流水號(hào)是String(16)批次內(nèi)唯一
memo備注否String(512)
req_reserve對(duì)賬碼否String(32)
cnaps_code聯(lián)行號(hào)否String(12)
cnaps_name開戶行名稱否String(64)跨行時(shí)為提高支付成功率請(qǐng)準(zhǔn)確填寫
is_private公私標(biāo)記否String(1)0：私人 1：公司
org_code機(jī)構(gòu)號(hào)否String(16)
source_note原始單據(jù)號(hào)否String(100)
extent1預(yù)留擴(kuò)展1否String(64)
extent2預(yù)留擴(kuò)展2否String(64)
protocol_code簽約全局唯一協(xié)議號(hào)是String(30)代收必填
agreement_no銀行代收協(xié)議編號(hào)否String(30)目前交行需要
sign_bus_type收付種類否String(3)
prd_name險(xiǎn)種名稱否String(40)一筆保單有多個(gè)險(xiǎn)種時(shí)，僅返回主險(xiǎn)險(xiǎn) 種名稱，若有值則會(huì)展現(xiàn)在客戶簽約授 權(quán)短信內(nèi)容中
mobile手機(jī)號(hào)否String(16)簽約扣款必填

響應(yīng)(resp_data)

字段名稱內(nèi)容是否必輸最大長度備注
req_seq_no批次號(hào),全局唯一否String(8)
trans_state交易狀態(tài)否String(8)3:整批失敗4:提交成功，處理中
pay_info_code批次號(hào),全局唯一否String(8)
verify_code驗(yàn)簽碼否String(180)簽碼，企業(yè)-驗(yàn)簽字段：`enterprise_num`_`req_seq_no`_`trans_state`(企業(yè)編號(hào)_流水號(hào)_交易狀態(tài)) 注：僅“3-整批失敗”時(shí)需要簽名驗(yàn)簽
vch_id憑證編號(hào)否String(8)


請(qǐng)求示例

{
    "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": "3",
        "req_seq_no": "ccbbds2024052800001",
        "trans_param": {
            "rec_act": "43050179373600000471",
            "corp_bank_code": "GJ101",
            "detail_record": [{
                "pay_name": "敖八九",
                "pay_act": "6227002920120342761",
                "pay_bank_code": "GJ101",
                "pay_area": "110100",
                "rec_act": "43050179373600000471",
                "rec_bank_code": "GJ101",
                "pay_amount": "1",
                "pay_cur": "CNY",
                "post_script_no": "1",
                "usage": "測(cè)試摘要",
                "memo": "測(cè)試備注",
                "card_type": "0"
            },
            {
                "pay_name": "丁四七",
                "pay_act": "4367422928030302997",
                "pay_bank_code": "GJ101",
                "pay_area": "110100",
                "rec_act": "43050179373600000471",
                "rec_bank_code": "GJ101",
                "pay_amount": "2",
                "pay_cur": "CNY",
                "post_script_no": "2",
                "usage": "測(cè)試摘要",
                "memo": "測(cè)試備注",
                "card_type": "0"
            }]
        }
    }
}復(fù)制


響應(yīng)示例

{
    "ret_code": "000000",
    "ret_msg": "success",
    "req_time": "20240528174343",
    "resp_data": {
        "vch_id": "VS202405285195071084",
        "trans_date": "",
        "trans_state": "4",
        "req_seq_no": "ccbbds2024052800001",
        "pay_info_code": "",
        "verify_code": ""
    }
}復(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",
        "total_num": "2",
        "total_amt": "1000",
        "req_seq_no": "BATds302405280002",
        "verify_code": "V+DEiEQJ1pCjTo3Why1NTy2adldvNDrvTO7UHbgrxxYWGeReStDY7KFptC2sj3W75UjIq2Bhsd+LE8SBqo0guX1TuyepzeoEQhygFg4f9ZOWugaIaBm9XxU6Sie74rUJ6z1Jy4NWdLsolBnuqypQd6J3CGlvkCrI0HNkGly3rsE=",
        "trans_param": {
            "rec_act": "105330102",
            "corp_bank_code": "BR105",
            "detail_record": [{
                "pay_name": "小紅",
                "pay_act": "6217001540000547001",
                "pay_area": "110100",
                "pay_bank_code": "BR105",
                "rec_act": "105330102",
                "rec_bank_code": "BR105",
                "card_type": "0",
                "pay_amount": "300",
                "pay_cur": "CNY",
                "post_script_no": "1",
                "mobile": "13800138000",
                "protocol_code": "2024052800003"
            },
            {
                "pay_name": "小紅",
                "pay_act": "6217001540000547001",
                "pay_area": "110100",
                "pay_bank_code": "BR105",
                "rec_act": "105330102",
                "rec_bank_code": "BR105",
                "card_type": "0",
                "pay_amount": "700",
                "pay_cur": "CNY",
                "post_script_no": "2",
                "mobile": "13800138000",
                "protocol_code": "2024052800003"
            }]
        }
    }
}復(fù)制


響應(yīng)示例2

{
    "ret_code": "000000",
    "ret_msg": "success",
    "req_time": "20240528174343",
    "resp_data": {
        "vch_id": "",
        "trans_state": "4",
        "req_seq_no": "BATds302405280002",
        "pay_info_code": "I1000",
        "verify_code": "V+DEiEQJ1pCjTo3Why1NTy2adldvNDrvTO7UHbgrxxYWGeReStDY7KFptC2sj3W75UjIq2Bhsd+LE8SBqo0guX1TuyepzeoEQhygFg4f9ZOWugaIaBm9XxU6Sie74rUJ6z1Jy4NWdLsolBnuqypQd6J3CGlvkCrI0HNkGly3rsE="
    }
}復(fù)制

錯(cuò)誤碼

錯(cuò)誤碼描述備注
000000成功-
其他失敗-


The End

標(biāo)簽：博主很懶，并沒有設(shè)置標(biāo)簽