Documentation Index
Fetch the complete documentation index at: https://sdk.qfapi.com/llms.txt
Use this file to discover all available pages before exploring further.
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
}
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.
