付款单查询
接口说明
请求方式:POST
接口地址:baseUrl/remit/query
接口描述: 用户在付款操作台提交成功后,通过本接口查询付款订单状态,付款单信息及电子回单等
调用说明:
- 支持批量查询,每批次付款单数量不超过100笔
- 当付款单状态为 REMITING(付款中)时必须等待,请不要重复下单,避免资金损失
- 必须明确得到终态FAIL(失败)SUCCESS(成功),才能继续对该笔付款单做后续处理
- 当付款单状态为SUCCESS时,才会生成电子回单地址。如未查询到回单,可以稍后再次查询。
是否加密:是
请求参数
| 参数名 | 类型 | 必填 | 参数说明 | 示例 |
|---|---|---|---|---|
| customerNo | string | ✓ | 商户编号 | |
| requestNos | string | ✓ | 付款请求号 | 支持多个付款请求号查询,中间用英文逗号分隔。付款请求号为下单时上送的唯一编号 |
响应参数
| 参数名 | 类型 | 必填 | 参数说明 | |
|---|---|---|---|---|
| records | JSON[ ] | ✓ | 付款单记录 | |
| ├ requestNo | string | 付款请求号 | ||
| ├ remitBatchNo | string | 付款批次号 | 支付系统生成的唯一标识 | |
| ├ remitBillNo | string | ✓ | 付款单号 | 支付系统生成的唯一标识 |
| ├ customerNo | string | ✓ | 商户编号 | |
| ├ amount | string | ✓ | 付款金额 | 单位:元 |
| ├ feeCutWay | string | ✓ | 手续费扣款方式 | IN:内扣,OUT:外扣 |
| ├ fee | string | ✓ | 手续费 | 单位:元 |
| ├ payableAmount | string | ✓ | 实际到账金额 | 单位:元 |
| ├ payChannel | string | ✓ | 支付机构 | UNIONPAY:银联,YEEPAY:易宝,HUIFU:汇付天下,SXF:随行付, YSE:银盛支付,LKL:拉卡拉,NEWHUIFU:新汇付,PAB:平安银行 |
| ├ payCustomerNo | string | ✓ | 支付商户号 | 支付机构的商户号 |
| ├ status | string | ✓ | 状态 | INIT:待处理,SUCCESS:成功,REMITING:付款中,FAIL:失败,CLOSE:已关单 |
| ├ ereceiptUrl | string | ✓ | 电子回单链接 | |
| ├ remarks | string | ✓ | 原因说明 | 当付款异常时,会返回失败原因 |