WeChat H5 Payment (Third-Party Browser)

HTTP Request

POST /trade/v1/payment
pay_type: 800212 (WeChat H5 Payment)

Request Parameters

Field Name	Field Code	Required	Type	Description
Common Payment Params	—	Yes	—	See Request Format
Extended Info	`extend_info`	Yes	Object	See structure below

`extend_info` Structure

extend_info: {
  scene_info: {
    h5_info: {
      type: "Wap",                 // Scene type (fixed value)
      wap_url: "https://qfpay.global/h5/pay", // Mobile site URL
      wap_name: "qfpay"            // Mobile site name
    }
  },
  spbill_create_ip: "192.168.1.10" // User's real IP address
}

For IP acquisition details, see WeChat Docs

Extended Info Parameters

Field Code	Subfield Code	Sub-subfield Code	Required	Type	Description
`scene_info`			Yes	Object	Scene information
	`h5_info`		Yes	Object	H5 scene configuration
		`type`	Yes	String	Fixed value: `Wap`
		`wap_url`	Yes	String	Mobile website URL
		`wap_name`	Yes	String	Mobile website name
`spbill_create_ip`			Yes	String	Customer’s real IP

Response Parameters

Field Code	Subfield Code	Type	Field Name	Description
Common Response Params	—	—	—	See Response Format
Payment URL	`pay_url`	String	Payment URL	URL to redirect the user to complete payment

Example `pay_url`

https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx20161110163838f231619da20804912345&package=1037687096

Appended with `redirect_url`

https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx20161110163838f231619da20804912345&package=1037687096&redirect_url=https%3A%2F%2Fwww.wechatpay.com.cn

Additional Notes

Suitable for mobile websites, app-embedded browsers, and external mobile browsers.
❗ Not supported within the WeChat in-app browser.
wap_url and wap_name must match the actual mobile site information or WeChat may reject the request.
The IP address submitted must be the real client IP to avoid risk rejection by WeChat.

WeChat Mini Programs WeChat QR Code Payment

⌘I

Preparation

Business Scenarios

API Reference

In-Store Payments

Online Payments

Shared Endpoints

WeChat H5 Payment (Third-Party Browser)

HTTP Request

Request Parameters

`extend_info` Structure

Extended Info Parameters

Response Parameters

Example `pay_url`

Appended with `redirect_url`

Additional Notes

​HTTP Request

​Request Parameters

​extend_info Structure

​Extended Info Parameters

​Response Parameters

​Example pay_url

​Appended with redirect_url

​Additional Notes

HTTP Request

Request Parameters

`extend_info` Structure

Extended Info Parameters

Response Parameters

Example `pay_url`

Appended with `redirect_url`

Additional Notes