# Payment to place the order

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: nontaxunifiedorder

This interface is provided to the Commission for payment of orders.

# 1. How to call

# HTTPS calls

POST https://api.weixin.qq.com/nontax/unifiedorder?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 parameters`Query String parameters`

Parameter Name	type	Required to fill in	Introductions
access_token	string	yes	Interface invoke credentials, using access_token

# Request Body`Request Payload`

Parameter Name	type	Required to fill in	Introductions
appid	string	yes	appid
service_id	number	no	Service id
bank_id	string	no	Bank 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_account	string	no	Split up bank account numbers (do not fill in those who do not use the splitting mechanism)
mch_id	string	no	Specify 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.
openid	string	no	User ID. When trade_type is MWEB, it does not need to be filled; Other information must be filled in.
desc	string	yes	Description (name of service)
fee	number	yes	Total Amount (in units of units)
return_url	string	no	Payment Middle Page The page to be redirected after payment is completed (Weixin Mini Program Not required to place an order, other required)
ip	string	yes	Client IP
order_no	string	no	The order number. (The payment notice number and order number must be chosen.) If there is no payment notice number, fill in the order number)
payment_notice_no	string	no	Payment Notice Number (Payment Notice number and order number must be chosen twice). If there is no payment notice number, fill in the order number)
department_code	string	yes	Receipt unit code
department_name	string	yes	Name of receiving unit
payment_notice_type	number	no	Type of notification
region_code	string	yes	Administrative division codes
user_name	string	no	User Name
items	object	yes	Details of the sub-item of contributions
payment_notice_create_time	number	yes	Payment Notice Creation Time (timestamp, in seconds)
payment_expire_date	string	no	Payment Limit Date, Format YYYMMDD
scene	string	yes	The scene."biz": WeChat Official Account "ctiyservice": city service "miniprogram": Weixin Mini Program
app_appid	string	no	App's AppID, required when app orders
trade_type	string	no	The default is JSPI type, non-[ WeChat browser H5 order please fill in MWEB.
auto_call_pay	boolean	no	Payment Intermediate Page / Weixin Mini Program Whether to automatically adjust payment

# Body.items`Object Payload`

Details of the sub-item of contributions

Parameter Name	type	Required to fill in	Introductions
no	number	yes	Item numbers, such as 1, 2, 3
item_id	string	yes	Project coding
item_name	string	yes	Project Name
overdue	number	no	Late payments (in units of units)
penalty	number	no	Amount of additional penalty (in units of units)
fee	number	yes	Amount (inclusive of late fees and additional penalties, in units of decimal units)

# 3. Return Parameters

# `Response Payload`

Parameter Name	type	Introductions
errcode	number	Return code
errmsg	string	Return code description
user_name	string	User Name
fee	number	Total Amount (in units of units)
items	object	Details of the sub-item of contributions
payment_notice_no	string	Payment Notice Number
department_code	string	Receipt unit code
department_name	string	Name of receiving unit
payment_notice_type	number	Type of notification
region_code	string	Administrative division codes
payment_notice_create_time	number	Payment Notice Creation Time (timestamp, in seconds)
payment_expire_date	string	Payment Limit Date, Format YYYMMDD

# Res.items`Object Payload`

Details of the sub-item of contributions

Parameter Name	type	Introductions
no	number	Item numbers, such as 1, 2, 3
item_id	string	Project coding
item_name	string	Project Name
overdue	number	Late payments (in units of units)
penalty	number	Amount of additional penalty (in units of units)
fee	number	Amount (inclusive of late fees and additional penalties, in units of decimal units)

# 4. Note

There are no special considerations for this interface

# 5. Code examples

Example Requests

{
  "appid":"wx5f6e43071809a9dd",
  "service_id": 123,
  "bank_id":"470690268",
  "payment_notice_no":"440204190185356",
  "department_code":"143605002004",
  "payment_notice_type":1,
  "region_code":"440000"
}

Return an example

{
  "department_code":"143605002004",
  "department_name":"韶关市公安局交警支队市区一大队",
  "errcode":0,
  "errmsg":"通知书未缴款",
  "fee":20000,
  "items":[
    {
      "fee":20000,
      "item_id":"103050101200",
      "item_name":"交通违法罚款",
      "no":1,
      "overdue":0
    }
  ],
  "payment_notice_create_time":1508806661,
  "payment_notice_no":"440204190185356",
  "payment_notice_type":1,
  "region_code":"440000",
  "user_name":"叶*梅"
}

# 6. Error code

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

Error code	Error Description	Solutions
-1	system error	The system is busy, so the developer is asked to try again in a few minutes.
40001	invalid credential access_token isinvalid or not latest	access_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;