Tencent WeChat Pay JSAPI Payment API

Can I create payment orders programmatically with WeChat Pay API?

Yes. Use the POST /v3/pay/transactions/jsapi endpoint to create prepay orders. You must provide the AppID, merchant ID, user OpenID, order description, amount, and webhook notification URL. The API returns a prepay_id valid for 2 hours, which your client-side code uses to invoke the WeChat payment SDK. Through Jentic, agents search for 'create WeChat payment order', load the schema, and execute with automatic signature handling.

What are the rate limits for WeChat Pay API?

The OpenAPI spec indicates 429 rate limit responses but does not specify exact limits. Rate limits vary by merchant tier and payment scenario. Contact WeChat Pay merchant support or consult the documentation at https://pay.weixin.qq.com for your specific limits. Production merchants typically have higher thresholds than test accounts.

How do I query order status with WeChat Pay API?

You can query orders two ways: (1) GET /v3/pay/transactions/id/{transaction_id} using WeChat's transaction ID (only for paid orders), or (2) GET /v3/pay/transactions/out-trade-no/{out_trade_no} using your merchant order number (works for all order states). Both require the mchid query parameter. The response includes trade_state (SUCCESS, NOTPAY, CLOSED, etc.) and full payment details.

Can I close unpaid orders through the WeChat Pay API?

Yes. Use POST /v3/pay/transactions/out-trade-no/{out_trade_no}/close to close unpaid orders. Provide your merchant order number in the path and merchant ID in the request body. The endpoint returns 204 (no content) on success. Use this when users cancel checkout or orders expire without payment. Paid orders cannot be closed — you must initiate a refund instead (via separate refund API).

What webhook notifications does WeChat Pay send?

WeChat Pay sends encrypted webhook notifications to the notify_url specified when creating an order. The main event is payment success (trade_state: SUCCESS), sent immediately after the user completes payment. Webhooks include the full order details, payment time, and promotion information. You must decrypt the notification body using your API v3 key and verify the signature. Jentic handles webhook verification automatically for agent-driven integrations.

How do AI agents use WeChat Pay API through Jentic?

Agents search Jentic for intents like 'create WeChat payment order' or 'query WeChat transaction status'. Jentic returns the relevant operations with their schemas and handles complex signature authentication server-side. Agents call operations via Jentic's execution layer without implementing RSA signatures or certificate management. Integration drops from 3-5 days to under an hour. Start at https://app.jentic.com/sign-up.

Does WeChat Pay API support currencies other than CNY?

The API schema shows CNY as the default currency in the Amount schema, with a currency field that accepts other currency codes. However, WeChat Pay primarily operates in Chinese Yuan (CNY) for domestic transactions. For cross-border payments (foreign currencies), you need to use separate WeChat Pay cross-border merchant accounts and API modules. Consult WeChat Pay documentation for multi-currency support specific to your merchant account type.