文档

测试

上送缴费单

websocket测试

POST

https://api.leadnew.com.cn/bankpayment/index

请求参数

参数名

类型

描述

必填

action

string

固定值：upload

必填

payment_id

string

建行：9

必填

bills

array

缴费单，支持上送多个

必填

bill_id_third_sys

string

第三方订单号

必填

project_id

string

领新提供

必填

bill_date

string

缴费期（缴费期+查找项判重，重复上送会更新缴费单）

必填

invalid_time

string

缴费单有效期，可空，格式 yyyyMMdd

可选

duepay_amt

string

应缴总金额，明细项应缴总金额之和（单位元）

必填

pay_amt

string

实缴总金额，初始值上送0（单位元）

必填

free_amt

string

优惠金额，若没有优惠，则填写0（单位元）

可选

remark

string

备注

可选

merchant_org_id

string

默认0

必填

operator

string

操作员，如果无法填入操作员实际值，请填入能标识行业应用的字段

必填

vcode_send

string

前端查询订单时是否发送手机验证码（0-否 1-是）

可选

bill_detail

array

明细项

必填

id

string

领新提供

必填

duepay_amt

string

缴费明细项应缴总金额（单位元）

必填

pay_amt

string

缴费明细项实缴总金额，初始上送0（单位元）

必填

free_amt

string

缴费明细项优惠金额，若没有优惠，则填写0（单位元）

必填

custom_detail

array

查找项和展示项

必填

id

string

领新提供

必填

value

string

对应id类型的数值

必填

server_notify_url

string

异步通知支付结果网址

必填

sign

string

参考签名说明

必填

merchantid

string

领新提供

必填

响应参数

参数名

类型

描述

必填

result

int

成功标记：1 失败标记：0

必填

data

array

必填

trans_id

string

请求流水号

必填

bills_ids

array

缴费单id数组（上送多少个缴费单返回多少个对应第三方订单号的缴费单id）

必填

键名

string

键名为第三方订单号

必填

键值

string

行方返回的缴费单id，支付的时候需要提交这个行方返回的缴费单id

必填

bill_detail_ids

array

必填

键名

string

键名为第三方订单号

必填

键值

array

查找项和展示项数组

必填

键名

string

键名为上送时查找项和展示项id

必填

键值

string

行方返回的查找项和展示项id

必填

msg

string

result为0时固有出错信息

必填

说明 / 示例

二次上送同一个缴费期+查找项视为更新签名前字符串（参考）：action=upload&bills=[{"bill_id_third_sys":1668593809,"project_id":"213213590","bill_date":"20221209","invalid_time":"20221209","duepay_amt":"1","pay_amt":"1","free_amt":"0","merchant_org_id":"0","operator":"123","bill_detail":[{"id":"0000236778","duepay_amt":"1","pay_amt":"1","free_amt":"0"}],"custom_detail":[{"type":"search","id":"0000416005","value":"13338005129"}]}]&merchantid=xxx&payment_id=9&key=xxx

上一篇签名和demo说明

nextDoc 缴费单查询