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. Get started with Jentic One, the self-hosted execution layer.

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.

Can I limit what my agent is allowed to do with the WeChat Pay JSAPI Payment API?

Yes. Because you run Jentic One yourself, your own rules decide which WeChat Pay operations and which stored merchant credentials the agent may use. Since the transaction reference sits in the URL path (/v3/pay/transactions/out-trade-no/{out_trade_no}), you can pin the agent to a single order so it only queries that transaction and touches nothing else. Creating orders with POST /v3/pay/transactions/jsapi or closing them via the /close operation stays off limits until you explicitly grant those operations.