# 获取缴费订单列表
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:nontaxgetorderlist
本接口用于获取缴费订单列表
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/nontax/getorderlist?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
appid | string | 是 | appid |
region_code | string | 是 | 行政区划代码 |
department_code | string | 是 | 执收单位编码 |
payment_notice_no | string | 否 | 缴费通知书编号(缴费通知书编号和订单号必须二选一。如果没有缴费通知书编号,则填订单号) |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 说明 |
---|---|---|
errcode | number | 返回码 |
errmsg | string | 返回码描述 |
order_id_list | array | 已下单的订单id列表 |
paid_order_id | string | 已支付的订单id |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"appid": "wx5f6e43071809a9dd",
"payment_notice_no": "34000019081115065040",
"department_code": "065080906",
"region_code": "340000"
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"order_id_list": [
"AQCAxFJwcrQqI2BkDAqRH-UhDq2D",
"AQAAgrVxcrRuhXBkDAqRH-UhDq2D",
"AQCAFxFzcrQqI2BkDAqRH-UhDq2D",
"AQCA5_3kcrSQCxMJDAGMadMAAAAA",
"AQCA6ADlcrQqI2BkDAGMadMAAAAA",
"AQCA62hwdbQqI2BkDAqRH-U4tE4p"
],
"paid_order_id": "AQCA62hwdbQqI2BkDAqRH-U4tE4p"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
0 | ok或者in a normal state | ok是指从不正常变成正常 in a normal state是指本来就正常 |
40001 | invalid credential access_token isinvalid or not latest | access_token 无效或不为最新获取的 access_token,请开发者确认access_token的有效性 |
# 7. 适用范围
本接口在不同账号类型下的可调用情况:
小程序 | 公众号 | 服务号 |
---|---|---|
仅认证 | 仅认证 | 仅认证 |
- 仅认证:表示仅允许企业主体已认证账号调用,未认证或不支持认证的账号无法调用
- 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;