Overview
This node integrates with the Payfunnels API to manage subscriptions and payments. Specifically, for the Subscription - Cancel operation, it allows users to cancel an active subscription in different ways: immediately, at the end of the current billing period, or on a custom specified date.
Common scenarios where this node is beneficial include:
- Automating subscription cancellations based on user requests or business logic.
- Managing subscription lifecycle events within workflows, such as pausing or stopping recurring charges.
- Integrating subscription management into CRM or support systems to streamline customer service.
For example, a business could use this node to automatically cancel a customer's subscription immediately upon refund approval or schedule cancellation at the end of the billing cycle if the customer wants to continue using the service until then.
Properties
| Name | Meaning |
|---|---|
| Subscription ID | The unique identifier of the subscription to be canceled. |
| Cancellation Option | How the subscription should be canceled. Options: • Immediate • End Of The Period • Custom Date |
| Cancel Date | The specific date when the subscription should be canceled (required only if "Custom Date" is selected). Format: date-time |
Output
The node outputs JSON data representing the response from the Payfunnels API after attempting to cancel the subscription. This typically includes details about the canceled subscription status or confirmation of the cancellation request.
If multiple items are processed, each output item corresponds to one cancellation result paired with the input item.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Payfunnels API.
- The node makes HTTP requests to
https://api.payfunnels.com/n8n-integration. - Proper configuration of the API key credential in n8n is necessary for successful execution.
Troubleshooting
Common Issues:
- Invalid or missing Subscription ID will cause the API to reject the cancellation request.
- Selecting "Custom Date" without providing a valid cancel date will result in errors.
- Network or authentication failures due to incorrect API key or connectivity issues.
Error Messages:
- Errors returned from the API will be surfaced as node execution errors unless "Continue On Fail" is enabled.
- Typical error messages may include "Subscription not found", "Invalid cancellation option", or "Unauthorized".
Resolutions:
- Verify that the Subscription ID exists and is correct.
- Ensure the cancellation option matches the required inputs; provide a valid cancel date if using "Custom Date".
- Check API key validity and network connectivity.
- Enable "Continue On Fail" to handle errors gracefully in bulk operations.
Links and References
- Payfunnels API Documentation (Assumed URL for reference)
- n8n Documentation on HTTP Request Node (for understanding underlying HTTP calls)
- n8n Community Forum for troubleshooting and examples: https://community.n8n.io/