WeChat In-App Payments (Native App)

​

Prerequisites

• Register on the WeChat Open Platform
• Create an App and obtain an AppID
• Complete WeChat approval and onboarding

​

Real-name Verification (Optional)

• Applies to Mainland China users only
• The WeChat Wallet identity must match submitted details
• Users can still pay without linking a bank card
• Availability depends on merchant configuration and PayType support

​

SDK Downloads

​

API Request

​

HTTP Request

• Method: POST
• Endpoint: /trade/v1/payment
• PayType: 800210

​

Request Parameters

​

Real-Name Verification Format (extend_info)

{
  "user_creid": "430067798868676871",
  "user_truename": "\\u5c0f\\u6797"
}

• user_creid — Mainland China ID number
• user_truename — payer’s real name (Unicode or Chinese characters)

​

Sample Request

{
  "goods_info": "test_app",
  "goods_name": "qfpay",
  "out_trade_no": "ORDER_10001",
  "pay_type": "800210",
  "txamt": "10",
  "txcurrcd": "HKD",
  "txdtm": "2019-09-13 04:53:03",
  "udid": "DEVICE123"
}

​

API Response

​

Response Parameters

​

Sample Response

{
  "respcd": "0000",
  "respmsg": "",
  "pay_params": {
    "appid": "wx3c6896fa9b351f2a",
    "partnerid": "316525492",
    "prepayid": "wx131253044253463a81dc336e1254149882",
    "package": "Sign=WXPay",
    "noncestr": "7786db42d9a245c2b1cfc717ac59376e",
    "timestamp": 1568350384,
    "sign": "[sign string]"
  }
}

​

Calling the WeChat SDK

​

Required Parameter Mapping

• appid
• partnerid
• prepayid
• package
• noncestr
• timestamp
• sign

​

Summary

• Designed for native mobile apps only
• Requires WeChat Open Platform registration & AppID approval
• Payment flow is handled by the official WeChat SDK
• Always confirm final status using the Transaction Enquiry API