# Submit a swipe payment

Debugging Tools

Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide

Interface name: nontaxmicropay

When a payment request is submitted, WeChat returns the payment result synchronously.When the interface returns a system failure, wait 5 seconds to re-call to see the return code. When the result returns that a password is required in a user's payment, the interface can be recalled at intervals (10 seconds recommended) until there is a clear success, failure, or timeout (30 seconds recommended).

# 1. How to call

# HTTPS calls

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

# Cloud Calls

  • This interface does not support cloud calls

# Third party invocation

  • Third Party Platform calls are not supported by this interface.

# 2. Request parameters

# Query parametersQuery String parameters

Parameter NametypeRequired to fill inIntroductions
access_tokenstringyesInterface invoke credentials, using access_token

# Request BodyRequest Payload

Parameter NametypeRequired to fill inIntroductions
appidstringyesappid
bank_idstringnoBank ID (globally unique ID assigned by WeChat non-tax platform), randomly selected from the configured list of banks when not specified;The default production environment is not filled, the test environment needs to be filled
bank_accountstringnoSplit up bank account numbers (do not fill in those who do not use the splitting mechanism)
mch_idstringnoSpecify the funds to be settled to mch_id. Can only be settled to mch_id bound under bank_id. Automatically select one from the mch_id bound under bank_id when not filled.
descstringyesDescription (name of service)
feenumberyesTotal Amount (in units of units)
user_namestringnoUser Name
itemsobjectyesDetails of the sub-item of contributions
payment_notice_create_timenumberyesPayment Notice Creation Time (timestamp, in seconds)
payment_expire_datestringnoPayment Limit Date, Format YYYMMDD
payment_notice_nostringnoPayment Notice Number (Payment Notice number and order number must be chosen twice). If there is no payment notice number, fill in the order number)
order_nostringnoThe order number. (The payment notice number and order number must be chosen.) If there is no payment notice number, fill in the order number)
department_codestringyesReceipt unit code
department_namestringyesName of receiving unit
payment_notice_typenumbernoType of notification
region_codestringyesAdministrative division codes
auth_codestringyesScan the payment authorization code, and the device reads the user's barcode or QR code in WeChat (note: User barcode rule: 18 bits of pure digits, beginning with 10, 11, 12, 13, 14, 15)
order_idstringnoOrder number (if the previous request had a return order number, please fill in it)

# Body.itemsObject Payload

Details of the sub-item of contributions

Parameter NametypeRequired to fill inIntroductions
nonumberyesItem numbers, such as 1, 2, 3
item_idstringyesProject coding
item_namestringyesProject Name
overduenumbernoLate payments (in units of units)
penaltynumbernoAmount of additional penalty (in units of units)
feenumberyesAmount (inclusive of late fees and additional penalties, in units of decimal units)

# 3. Return Parameters

# Response Payload

Parameter NametypeIntroductions
errcodenumberReturn code
errmsgstringReturn code description
order_idstringorder number

# 4. Note

There are no special considerations for this interface

# 5. Code examples

Example Requests

{
    "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"
}

Return an example

{
    "errcode": 0,
    "errmsg": "ok",
    "order_id": "AQAA_UjjdbLiUjMKDJ7fvb4AAAAA"
}

# 6. Error code

The following is a list of error codes for this interface, other error codes can refer to General error codes

Error codeError DescriptionSolutions
40001invalid credential  access_token isinvalid or not latestaccess_token Invalid or not recently acquired access_token, please confirm the validity of the access_token

# 7. Scope of application

How this interface can be invoked under different account types:
Weixin Mini Program Official Account Service Account
Certification only Certification only Certification only
  • Authentication only: means that only authenticated accounts are allowed to be invoked by the enterprise entity, and accounts that are not authenticated or do not support authentication cannot be invoked.
  • Other account types that are not expressly stated may not be called on this interface without special instructions;