银直通批量代付

拉卡拉好拓客 15小时前 19:51:07 2

请求URL

测试环境：https://test.wsmsd.cn/sit/api/v3/ltbs/dsf/batch_df
生产环境：https://s2.lakala.com/api/v3/ltbs/dsf/batch_df


请求接口说明(req_data)

字段名称内容是否必输最大长度备注
merchant_no商户号是String(32)拉卡拉数科提供
示例：4002024052370293947
term_no终端号否String(32)
enterprise_num企业编号是String(10)拉卡拉数科提供
corp_bank_code发起方银行渠道代码是String(8)参见【银行渠道代码】
verify_code验签码否String(180)企业-验签字段(金额单位元，格式化成两位小数#.##)：`enterprise_num`_`req_seq_no`;`rec_act`_`pay_amount`;`rec_act`_`pay_amount`…(企业编号_批次号;明细-客户方账户_交易金额;明细-客户方账户_交易金额…);注：拼接的明细需按升序（字符串从小到大）的顺序进行排序
total_num总笔数是String(6)
total_amt总金额，分为单位是String(18)
req_seq_no批次号,全局唯一,数字字母是String(30)
accounting_flag记账标记否String(1)记账标记
1：单笔记账
2：按批记
3：汇总记账
trans_param交易明细信息是Object

trans_param字段说明

字段名称内容是否必输最大长度备注
pay_act企业方账号是String(32)
pay_area企业方区域代码否String(8)
pay_area_name企业方区域名称否String(60)
corp_bank_code企业方银行代码是String(8)
detail_record交易信息列表是Object具体交易信息可多个

detail_record 字段说明

字段名称内容是否必输最大长度备注
pay_name企业方户名否String(60)
pay_act企业方账号是String(32)
pay_bnk企业方银行开户行名否String(64)
pay_area企业方区域代码否String(8)
pay_bank_code企业方银行代码是String(8)
pay_bank_name企业方银行名称否String(64)
pay_area_name企业方区域名称否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客户方区域代码是String(8)
rec_area_name客户方区域名称否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企业方币种 CNY否String(3)
rec_cur客户方币种 CNY是String(3)
cert_type证件类型，银联跨行收必填否String(1)仅支持“0：身份证”类型
cert_num证件号，银联跨行收必填 签约扣款必填否String(32)
credit_card_sec_code信用卡验证码 银联标准卡称为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联行号否String(12)
cnaps_name开户行名称 跨行时为提高支付成功率请准确填写否String(64)
is_private公私标记否String(1)
org_code机构号否String(16)
source_note原始单据号否String(100)
extent1预留扩展1否String(64)
extent2预留扩展2否String(64)


响应(resp_data)

字段名称内容是否必输最大长度备注
req_seq_no批次号,全局唯一否String(8)
trans_state交易状态3:整批失败4:提交成功，处理中否String(8)
pay_info_code批次号,全局唯一否String(8)
verify_code验签码否String(180)签码，企业-验签字段：`enterprise_num`_`req_seq_no`_`trans_state`(企业编号_流水号_交易状态) 注：仅“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

标签：博主很懒，并没有设置标签