N8N Tools - PayPal Enhanced icon

N8N Tools - PayPal Enhanced

Complete PayPal integration with 70+ operations including Orders, Subscriptions, Invoicing, Disputes, Webhooks, and Partner management

Subscriptions → Suspend Subscription

AI-generated

Overview

The node provides enhanced integration with PayPal, supporting over 70 operations across multiple PayPal resources such as Orders, Subscriptions, Invoicing, Disputes, Webhooks, and more. Specifically, the Suspend Subscription operation allows users to suspend an active PayPal subscription by its ID.

This node is beneficial for automating PayPal billing workflows within n8n, such as managing subscriptions lifecycle events (create, suspend, cancel, activate), handling orders and payments, or managing invoices and disputes. For example, a business can automatically suspend a customer's subscription based on external triggers or conditions without manual intervention.

Properties

Name Meaning
ID The unique identifier of the subscription to be suspended.
Additional Options Optional parameters including:
- Environment: Choose between "Sandbox" (test) or "Live" PayPal environment.
- Page Size: Number of items per page for list operations (not relevant for suspend action).
- Start Time: Filter start date in ISO 8601 format (not relevant for suspend action).
- End Time: Filter end date in ISO 8601 format (not relevant for suspend action).

Output

The node outputs a JSON object containing:

  • resource: The resource type, here always "subscriptions".
  • operation: The operation performed, here "suspendSubscription".
  • success: Boolean indicating if the operation succeeded.
  • All fields returned by the PayPal API response for the suspend subscription endpoint.
  • creditsUsed and creditsRemaining: Information about API usage credits from the validation step.
  • timestamp: The ISO timestamp when the operation was executed.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for:
    • An API key credential for the external "N8N Tools API" used for operation validation.
    • A PayPal OAuth2 API credential providing an access token and environment info.
  • The node makes HTTP requests to both the N8N Tools API and PayPal's REST API endpoints.
  • Proper configuration of these credentials in n8n is necessary for successful execution.

Troubleshooting

  • Invalid JSON in Request Body: If a request body is provided but contains invalid JSON, the node throws an error. Ensure JSON syntax correctness.
  • Validation Failure: If the external validation API rejects the operation, the node will throw an error indicating validation failure.
  • Unknown Operation or Resource: Errors occur if unsupported operations or resources are specified.
  • API Authentication Issues: Invalid or expired PayPal OAuth tokens will cause authentication errors; refresh or reconfigure credentials.
  • Network or API Errors: Any HTTP request failures to PayPal or the validation API will result in errors. Check network connectivity and API status.
  • To continue processing other items despite errors, enable the "Continue On Fail" option in the node settings.

Links and References

Discussion