Application ID

applyment_id

int

Yes

Path Unique ID of the H5 authorization application.
Example: 100000

Sub-merchant ID

sub_mchid

string[1, 32]

Yes

ID of the sub-merchant under the current institution/service provider.
Example: 2491935631

Web payment domain

domains

array

Yes

The domain that pulls web payment.
Example: ["qq.com"]

Company profile and business description

business_description

string[1, 500]

No

This field is required when NO_LIMIT is selected for transaction_limit_type.
Example: Founded in November 1998, Tencent is an Internet-based platform company that uses technology to enrich the lives of Internet users and assist enterprises with digital upgrade. Our mission is "Value for Users, Tech for Good".

Limit type

transaction_limit_type

string

Yes

Web payment limit type. Valid values:
UN_LAUNCHED_WEBSITE_LIMIT: The payment limit for a website not launched.
Limited Quota: ①1000 CNY/day/person
if touched the transaction limit of the H5 payment, this customer couldn't pay to this sub-merchant through H5 channel on this day （re-accumulate in the next day）

② 50000 CNY/day/sub-merchant

if touched the transaction limit of the H5 payment, this sub-merchant couldn't recevie money through H5 channel on this day（re-accumulate in the next day）

NORMAL_LIMIT: The payment limit authorized when the information is incomplete. This value is used by default if this field is not specified.
Limited Quota：
①50000 CNY/day/person,if touched the payment limit of the H5 payment limited quota, this customer couldn't pay to this sub-merchant through H5 channel on this day （re-accumulate in the next day）
② 500000 CNY/day/sub-merchant, if touched the payment limit of the H5 payment limited quota,
this sub-merchant couldn't recevie money through H5 channel on this day （re-accumulate in the next day）

NO_LIMIT: No payment limit.

Example: UN_LAUNCHED_WEBSITE_LIMIT

Certificate of incorporation

company_register_cert

string[1, 128]

No

This field is required when NO_LIMIT is selected for transaction_limit_type.
Example: 6uqyGjvHzOhsLleGFQVRF

Website business page screenshot

website_business_page_pics

array

No

This field is required when the website is not launched. The value is a media ID, which can be obtained via the image upload API
Example: ["6uqyGjvHzOhsLleGFQVRF"]

Website homepage screenshot

website_homepage_pics

array

No

This field is required when the website is not launched. The value is a media ID, which can be obtained via the image upload API
Example: ["6uqyGjvHzOhsLleGFQVRF"]

Sub-merchant's website status

website_state

string

Yes

The status of the sub-merchant's website. Valid values:
HAS_LAUNCHED: The website has been launched.
UN_LAUNCHED: The website is not launched.
Example: HAS_LAUNCHED

Sub-merchant's website URL

website_url

string[1, 128]

Yes

The URL of the website on which the sub-merchant's business categories, products/services and prices are displayed and users can place orders.
Example: https://qq.com

Application ID

applyment_id

int

Yes

Unique ID of the H5 authorization application.
Example: 100000

Rejection reason

audit_reject_detail

string[1, 500]

No

The reason why the request is rejected.
Example: The merchant's certificate does not meet requirements.

Request status

applyment_state

string

Yes

Web payment request status. Valid values:
PENDING: The request is not created. Query again later or check whether the submission is normal.
UNDER_REVIEW: The request is created and under review.
APPROVED: The request is approved.
REJECTED: The request is rejected. See audit_reject_detail for the rejection reason.
Example: PENDING

Request type

applyment_type

string

Yes

Web payment request type. Valid values:
APPLY_FOR_PAYMENT_AUTHORITY: The request for web payment authorization.
APPLY_FOR_RELIEVE_LIMITED: The request for web payment limit removal.
Example: APPLY_FOR_PAYMENT_AUTHORITY

Callback API provided by merchants to receive review results

notify_url

string[1, 128]

No

The HTTPS protocol is required. If the URL cannot be accessed, the merchant will not receive any WeChat notifications. The notification URL must be directly accessible without any parameters.
For more information, please refer to Authorization Result Notification
Example: https://pay.weixin.qq.com/wxpay/pay.action

Returned status code

code

string[1,32]

Yes

Error code. See the error code list for the enumerated values.

Returned information

message

string[1,256]

Yes

Returned message. It indicates the reason for the error if not empty.

Detailed error description

detail

object

No

It is returned when code is PARAM_ERROR. Details will be described below.

500

SYSTEM_ERROR

System error

Call the API again later with the same parameters.

429

FREQUENCY_LIMIT_EXCEED

Frequency limit, please try it later

Frequency limit, please try it later

400

PARAM_ERROR

The request number does not exist. Check and try again.

The request number does not exist. Check and try again.