银直通批量代收

好拓客 14小时前 19:48:44 1

请求URL

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


请求接口说明(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字段说明

字段名称内容是否必输最大长度备注
rec_act企业方账号是String(32)
rec_area企业方区域代码否String(8)
rec_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卡折标记是String(1)0：卡 1：折
same_city是否同城否String(1)1：同城
same_bnk是否同行否String(1)1：同行
pay_date交易日期否String(8)yyyyMMdd
pay_time交易时间否String(6)HHmmss
pay_amount交易金额是String(18)单位分
pay_cur客户方币种是String(3)CNY：人民币
rec_cur企业方币种否String(3)CNY：人民币
cert_type证件类型否String(1)0：身份证
cert_num证件号否String(32)签约扣款必填
credit_card_sec_code信用卡验证码否String(100)银联标准卡称为CVN2，万事达卡称为CVC2，VISA卡称为CVV2，AE运通卡则称为CSC2
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)0：私人 1：公司
org_code机构号否String(16)
source_note原始单据号否String(100)
extent1预留扩展1否String(64)
extent2预留扩展2否String(64)
protocol_code签约全局唯一协议号是String(30)代收必填
agreement_no银行代收协议编号否String(30)目前交行需要
sign_bus_type收付种类否String(3)
prd_name险种名称否String(40)一笔保单有多个险种时，仅返回主险险 种名称，若有值则会展现在客户签约授 权短信内容中
mobile手机号否String(16)签约扣款必填

响应(resp_data)

字段名称内容是否必输最大长度备注
req_seq_no批次号,全局唯一否String(8)
trans_state交易状态否String(8)3:整批失败4:提交成功，处理中
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": "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": "测试摘要",
                "memo": "测试备注",
                "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": "测试摘要",
                "memo": "测试备注",
                "card_type": "0"
            }]
        }
    }
}复制


响应示例

{
    "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": ""
    }
}复制


请求示例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"
            }]
        }
    }
}复制


响应示例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="
    }
}复制

错误码

错误码描述备注
000000成功-
其他失败-


The End

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