Actions33
- Mini Program Actions
- Official Account Actions
- WeChat Pay Actions
- WeChat Work Actions
Overview
The WeChat Pay - Download Bill operation allows users to download transaction bills from WeChat Pay for a specified date and bill type. This node is useful for financial reconciliation, auditing, and record-keeping by retrieving detailed transaction data directly from WeChat Pay.
Typical scenarios include:
- Automatically fetching daily or monthly transaction reports.
- Integrating WeChat Pay billing data into accounting or ERP systems.
- Monitoring payment success, refunds, or revoked transactions for business analysis.
For example, a merchant can schedule this node to run daily to download the previous day's transaction bill of all types ("All") and store it in their database for further processing.
Properties
| Name | Meaning |
|---|---|
| Bill Date | The date of the bill to download, formatted as YYYYMMDD (e.g., 20230401 for April 1, 2023). Required. |
| Bill Type | The type of bill to download. Options: "All" (ALL), "Success" (SUCCESS), "Refund" (REFUND), "Revoked" (REVOKED). Default is "All". |
Output
The output JSON contains the downloaded bill data returned by the WeChat Pay API. This typically includes detailed transaction records for the specified date and bill type.
- The exact structure depends on the WeChat Pay API response but generally includes fields such as transaction IDs, amounts, statuses, refund details, and timestamps.
- The node does not explicitly handle binary data output for this operation; the bill data is returned as structured JSON or text content.
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 (
WeChatApi) to interact with WeChat Pay endpoints. - Network connectivity to WeChat Pay services and the N8N Tools API endpoint is necessary.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error about invalid subscription or API key, verify that the API key credential is correctly set up and has the required permissions.
- Unsupported operation error: Ensure the operation selected is exactly "Download Bill" under the "WeChat Pay" resource.
- Date format issues: The "Bill Date" must be provided in the correct YYYYMMDD format. Incorrect formatting may cause API errors.
- API rate limits or network errors: Temporary failures contacting WeChat Pay or the N8N Tools API may occur. Retrying after some time or checking network/firewall settings can help.
- Empty or malformed bill data: If the returned bill data is empty or unexpected, confirm that there were transactions on the specified date and that the bill type matches available data.
Links and References
- WeChat Pay Official Documentation - Download Bill
- n8n Documentation - Creating Custom Nodes
- N8N Tools API Service (for API key management and validation)