# 提交刷卡支付
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:nontaxmicropay
提交支付请求后微信会同步返回支付结果。 接口返回系统失败时,等待5秒重新调用看返回码。 当结果返回用户支付中需要输入密码时,可每间隔一段时间(建议10秒)重新调用该接口,直到有明确成功、失败,或者超时(建议30秒)
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/nontax/micropay?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
appid | string | 是 | appid |
bank_id | string | 否 | 银行id(由微信非税平台分配的全局唯一id),不指定时在已配置的银行列表中随机选择;不填时默认生产环境,测试环境需填上 |
bank_account | string | 否 | 清分银行账号(不使用清分机制的不用填) |
mch_id | string | 否 | 指定资金结算到mch_id。只能结算到 bank_id 下绑定的mch_id。不填时自动从 bank_id 下绑定的 mch_id 选择一个。 |
desc | string | 是 | 描述(服务名称) |
fee | number | 是 | 总金额(单位是分) |
user_name | string | 否 | 用户姓名 |
items | object | 是 | 缴费子项目详情 |
payment_notice_create_time | number | 是 | 缴款通知书创建时间(时间戳,单位是秒) |
payment_expire_date | string | 否 | 限缴日期,格式YYYYMMDD |
payment_notice_no | string | 否 | 缴费通知书编号(缴费通知书编号和订单号必须二选一。如果没有缴费通知书编号,则填订单号) |
order_no | string | 否 | 订单号。(缴费通知书编号和订单号必须二选一。如果没有缴费通知书编号,则填订单号) |
department_code | string | 是 | 执收单位编码 |
department_name | string | 是 | 执收单位名称 |
payment_notice_type | number | 否 | 通知书类型 |
region_code | string | 是 | 行政区划代码 |
auth_code | string | 是 | 扫码支付授权码,设备读取用户微信中的条码或者二维码信息(注:用户刷卡条形码规则:18位纯数字,以10、11、12、13、14、15开头) |
order_id | string | 否 | 订单号(之前请求有返回订单号则填上) |
# Body.items Object Payload
缴费子项目详情
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
no | number | 是 | 项目号,如1,2,3 |
item_id | string | 是 | 项目编码 |
item_name | string | 是 | 项目名称 |
overdue | number | 否 | 滞纳金(单位是分) |
penalty | number | 否 | 加罚金额(单位是分) |
fee | number | 是 | 金额(包含滞纳金和加罚金额,单位是分) |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 说明 |
---|---|---|
errcode | number | 返回码 |
errmsg | string | 返回码描述 |
order_id | string | 订单号 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"appid": "wx5f6e43071809a9dd",
"bank_id": "test_bank_id",
"bank_account": "",
"desc": "测试办证缴费",
"fee": 1,
"user_name": "*三强",
"items": [
{
"no": 1,
"item_id": "000001",
"item_name": "测试办证缴费1",
"overdue": 0,
"fee": 1
},
{
"no": 2,
"item_id": "000002",
"item_name": "测试办证缴费2",
"overdue": 0,
"fee": 0
}
],
"payment_notice_create_time": 1500967298,
"payment_expire_date": "20190102",
"payment_notice_no": " 08111639088",
"department_code": "118610002",
"department_name": "测试执收单位",
"region_code": "440000",
"auth_code": " 134971951305811268"
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"order_id": "AQAA_UjjdbLiUjMKDJ7fvb4AAAAA"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
40001 | invalid credential access_token isinvalid or not latest | access_token 无效或不为最新获取的 access_token,请开发者确认access_token的有效性 |
# 7. 适用范围
本接口在不同账号类型下的可调用情况:
小程序 | 公众号 | 服务号 |
---|---|---|
仅认证 | 仅认证 | 仅认证 |
- 仅认证:表示仅允许企业主体已认证账号调用,未认证或不支持认证的账号无法调用
- 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;