Actions33
- Mini Program Actions
- Official Account Actions
- WeChat Pay Actions
- WeChat Work Actions
Overview
The WeChat Pay - Query Refund operation allows users to check the status and details of a refund transaction processed through WeChat Pay. This node is useful in scenarios where merchants or service providers need to verify whether a refund has been successfully processed, is pending, or has failed. It helps maintain accurate financial records and improves customer service by providing timely refund information.
Practical examples:
- An e-commerce platform automatically queries refund statuses to update order records and notify customers.
- A merchant uses this node to reconcile refunds issued during a specific period.
- Customer support teams use it to quickly check refund progress when handling inquiries.
Properties
| Name | Meaning |
|---|---|
| Transaction ID | The unique WeChat Pay transaction ID associated with the original payment. |
| Out Trade No | The merchant's internal order number related to the payment or refund. |
| Out Refund No | The merchant's internal refund number used to identify the refund request. |
| Refund ID | The unique refund ID assigned by WeChat Pay for the refund transaction. |
Output
The output JSON contains detailed information about the refund query result returned by the WeChat Pay API. This typically includes:
- Refund status (e.g., success, processing, failed)
- Refund amounts
- Associated transaction and refund IDs
- Timestamps and other metadata related to the refund process
This structured data enables downstream workflow steps to make decisions based on refund outcomes.
The node does not output binary data for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external N8N Tools API service that acts as a proxy/validator for WeChat API calls.
- Requires credentials for WeChat Pay API access configured in n8n.
- The node internally uses a helper class to interact with WeChat Pay endpoints via the N8N Tools API.
Troubleshooting
Invalid subscription or API key error:
If you receive errors indicating invalid subscription or API key, verify that your API key credential is correctly set up and active in n8n.Missing or incorrect parameters:
Ensure at least one identifier amongTransaction ID,Out Trade No,Out Refund No, orRefund IDis provided. Supplying none or invalid values may cause the API call to fail.API rate limits or connectivity issues:
Network problems or exceeding API rate limits can cause failures. Check network connectivity and consider retry logic or increasing limits if possible.Error messages from WeChat Pay API:
These will be passed through; consult WeChat Pay documentation for specific error codes and resolutions.
Links and References
- WeChat Pay Official Documentation - Refund Query
- N8N Documentation - Creating Custom Nodes
- N8N Tools API Service (for API key management and usage)
If you need further details on other operations or resources, feel free to ask!