Overview
This node integrates with the Payfunnels API to manage subscriptions and payments. Specifically, for the Subscription - List operation, it retrieves a paginated list of subscriptions from the Payfunnels platform. Users can filter the list by customer email and control pagination through limit and page number parameters.
Common scenarios where this node is beneficial include:
- Fetching subscription data for reporting or analytics.
- Synchronizing subscription records with other systems.
- Monitoring active subscriptions filtered by customer email.
Example: A user wants to retrieve the first 50 subscriptions on page 1 that belong to customers with a specific email address to analyze subscription trends.
Properties
| Name | Meaning |
|---|---|
| Limit | Max number of subscription results to return (minimum 1). |
| Page | Page number of the subscription list to retrieve (minimum 1). |
| Filter subscriptions by customer email address (partial or full match). |
Output
The output is an array of JSON objects representing subscription records retrieved from the Payfunnels API. Each item corresponds to one subscription and contains all relevant subscription details as provided by the API.
If multiple subscriptions are returned, each is output as a separate item in the node's output array.
No binary data is output by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the Payfunnels API.
- The node makes HTTP GET requests to
https://api.payfunnels.com/n8n-integration/subscriptions. - Proper network access to the Payfunnels API endpoint is necessary.
Troubleshooting
Common issues:
- Invalid or missing API key will cause authentication failures.
- Network connectivity problems may prevent reaching the Payfunnels API.
- Providing invalid parameter values (e.g., negative limit or page) may result in errors.
Error messages:
- Authentication errors typically indicate issues with the API key; verify the credential configuration.
- HTTP errors from the API (e.g., 400 or 500 status codes) usually include descriptive messages; check the parameters sent.
- If the node throws an error about invalid input, ensure that "Limit" and "Page" are positive integers and "Email" is a valid string.
To handle errors gracefully, enable the "Continue On Fail" option in the node settings to process subsequent items even if some fail.
Links and References
- Payfunnels API Documentation (assumed URL based on domain)
- n8n Documentation on HTTP Request Node (for understanding underlying HTTP calls)