银直通单笔代付
请求URL
测试环境：https://test.wsmsd.cn/sit/api/v3/ltbs/dsf/df
生产环境：https://s2.lakala.com/api/v3/ltbs/dsf/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` _`trans_no`_`cust_acc_num`_`cust_acc_name`_`amount` (企业编号_流水号_客户帐号_帐户名称_交易金额) |
| trans | 交易明细信息 | 是 | Object |
trans字段说明
| 字段名称 | 内容 | 是否必输 | 最大长度 | 备注 |
|---|---|---|---|---|
| trans_no | 16位流水号，永久唯一 | 是 | String(16) | |
| protocol_code | 签约扣款必填，签约全局唯一协议号 | 否 | String(30) | |
| enterprise_acc_num | 企业帐号 | 是 | String(32) | |
| cust_bank_code | 客户银行编码 | 否 | String(8) | |
| cust_acc_num | 客户帐号 | 是 | String(32) | |
| cust_acc_name | 客户帐户名称 | 是 | String(60) | |
| area_code | 地级市统一编码 | 否 | String(8) | |
| bank_location_code | 联行号 | 否 | String(12) | |
| bank_location_name | 开户行名称 | 否 | String(64) | |
| card_type | 卡折标识,，农行需填正确 | 是 | String(1) | |
| is_private | 公私标志，农行需填正确 | 是 | String(1) | |
| is_urgent | 加急标记 | 否 | String(1) | |
| amount | 交易金额,单位分 | 是 | String(21) | |
| currency | 币种 | 否 | String(3) | |
| cert_type | 证件类型 | 否 | String(1) | 仅支持“0：身份证”类型 |
| cert_num | 证件号码 | 否 | String(32) | |
| mobile | 手机号码 | 否 | String(11) | |
| reconciliation_code | 对账码 | 否 | String(32) | |
| purpose | 用途 | 否 | String(32) | |
| memo | 备注 | 否 | String(64) | |
| org_code | 机构号 | 否 | String(16) | |
| source_note | 原始单据号 | 否 | String(64) | |
| extent1 | 预留扩展1 | 否 | String(100) | |
| extent2 | 预留扩展2 | 否 | String(100) |
响应(resp_data)
| 字段名称 | 内容 | 是否必输 | 最大长度 | 备注 |
|---|---|---|---|---|
| trans_date | 交易日期 | 否 | String(8) | yyyyMMdd |
| verify_code | 验签码 | 否 | String(180) | 企业-验签字段(金额单位元，格式化成两位小数#.##)：`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": {
"trans_no": "ccbdf2024052800001",
"enterprise_acc_num": "43050179373600000471",
"cust_acc_num": "6227002920120342761",
"cust_acc_name": "敖八九",
"card_type": "0",
"is_private": "0",
"currency": "CNY",
"amount": "100"
}
}
}复制响应示例
{
"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",
"verify_code": "nQuVzko6m0lEzIhqDml5jRmo0fmLNuWW4iKIEVyfYmoU10a045oPMYWCqHDe+vO1k0qosaP1ixm9h+ZE/wOJrTHZSwF+JJP5rKci3OMQ6M6Mbj7+a7mZv+TkH+NRKXsFlk/1z1LjkIPYfsdrjTPIzCEUP8vyp/kJvb/WdHJDNU4=",
"trans": {
"trans_no": "BRdf2024052820003",
"enterprise_acc_num": "102330101",
"cust_acc_num": "617420100037139511",
"cust_acc_name": "测试",
"card_type": "0",
"is_private": "0",
"currency": "CNY",
"amount": "1000"
}
}
}复制响应示例2
{
"ret_code": "000000",
"ret_msg": "success",
"req_time": "20240528174343",
"resp_data": {
"trans_date": "20240528",
"verify_code": "q4aXKLvwsDf5EV0fHdmorXQE5QDUxmJIWAjgR6C2BKuzM+5noc3lSa5V7amIQ7S3kijQyFKa0TpeeJUslJVVa6q7BjgrML/yoMFRvEaJ6pibjRO7Nfm/IgBAWejtmkEBAwWDFMSWN9bz+upfYlkDVSszfyq0zKTOlyOo+W1Zo4E=",
"trans": {
"amount": "1000",
"bank_extent1": "20240528",
"cert_type": "0",
"currency": "CNY",
"cust_acc_name": "测试",
"cust_acc_num": "617420100037139511",
"cust_bank_code": "GJ101",
"fg_trans_time": "20240528204859",
"info": "S0000::支付成功::交易成功",
"info_code": "S0000",
"state": "2",
"trans_no": "BRdf2024052820003"
}
}
}复制错误码
| 错误码 | 描述 | 备注 |
|---|---|---|
| 000000 | 成功 | - |
| 其他 | 失败 | - |
The End