# 提交刷卡支付

调试工具

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:nontaxmicropay

提交支付请求后微信会同步返回支付结果。 接口返回系统失败时,等待5秒重新调用看返回码。 当结果返回用户支付中需要输入密码时,可每间隔一段时间(建议10秒)重新调用该接口,直到有明确成功、失败,或者超时(建议30秒)

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/nontax/micropay?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填说明
access_tokenstring接口调用凭证,可使用 access_token

# 请求体 Request Payload

参数名类型必填说明
appidstringappid
bank_idstring银行id(由微信非税平台分配的全局唯一id),不指定时在已配置的银行列表中随机选择;不填时默认生产环境,测试环境需填上
bank_accountstring清分银行账号(不使用清分机制的不用填)
mch_idstring指定资金结算到mch_id。只能结算到 bank_id 下绑定的mch_id。不填时自动从 bank_id 下绑定的 mch_id 选择一个。
descstring描述(服务名称)
feenumber总金额(单位是分)
user_namestring用户姓名
itemsobject缴费子项目详情
payment_notice_create_timenumber缴款通知书创建时间(时间戳,单位是秒)
payment_expire_datestring限缴日期,格式YYYYMMDD
payment_notice_nostring缴费通知书编号(缴费通知书编号和订单号必须二选一。如果没有缴费通知书编号,则填订单号)
order_nostring订单号。(缴费通知书编号和订单号必须二选一。如果没有缴费通知书编号,则填订单号)
department_codestring执收单位编码
department_namestring执收单位名称
payment_notice_typenumber通知书类型
region_codestring行政区划代码
auth_codestring扫码支付授权码,设备读取用户微信中的条码或者二维码信息(注:用户刷卡条形码规则:18位纯数字,以10、11、12、13、14、15开头)
order_idstring订单号(之前请求有返回订单号则填上)

# Body.items Object Payload

缴费子项目详情

参数名类型必填说明
nonumber项目号,如1,2,3
item_idstring项目编码
item_namestring项目名称
overduenumber滞纳金(单位是分)
penaltynumber加罚金额(单位是分)
feenumber金额(包含滞纳金和加罚金额,单位是分)

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber返回码
errmsgstring返回码描述
order_idstring订单号

# 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. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

错误码错误描述解决方案
40001invalid credential  access_token isinvalid or not latestaccess_token 无效或不为最新获取的 access_token,请开发者确认access_token的有效性

# 7. 适用范围

本接口在不同账号类型下的可调用情况:
小程序公众号服务号
仅认证 仅认证 仅认证
  • 仅认证:表示仅允许企业主体已认证账号调用,未认证或不支持认证的账号无法调用
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;