N8N Tools - PayPal EnhancedInstall

Overview

The node "N8N Tools - PayPal Enhanced" provides a comprehensive integration with PayPal, supporting over 70 operations across multiple PayPal resources such as Orders, Subscriptions, Invoicing, Disputes, Webhooks, Payments, Products, Plans, Partner Referrals, and Reporting.

Specifically for the Disputes resource and the Show Dispute Details operation, this node fetches detailed information about a specific dispute by its ID. This is useful in scenarios where you need to monitor or manage disputes and chargebacks on your PayPal account programmatically within an n8n workflow.

Practical examples:

• Automatically retrieve dispute details when a new dispute notification webhook is received.
• Use dispute details to trigger alerts or update CRM/customer support systems.
• Integrate dispute data into financial reporting or reconciliation workflows.

Properties

Output

The output JSON object includes:

• resource: The resource name, here always "disputes".
• operation: The operation performed, here "showDisputeDetails".
• success: Boolean indicating if the API call was successful.
• All fields returned by the PayPal API for the dispute details, which typically include dispute status, reason, parties involved, transaction details, evidence submitted, and timeline events.
• creditsUsed and creditsRemaining: Information about API usage credits from the external validation service.
• timestamp: The ISO timestamp when the data was retrieved.

If the node encounters an error and "Continue On Fail" is enabled, it outputs an object with:

• error: The error message.
• success: false.
• resource and operation for context.

No binary data is output by this operation.

Dependencies

• Requires credentials for:
  • An external API key credential for the "N8N Tools API" used for validating operations and tracking usage.
  • A PayPal OAuth2 API credential providing an access token and environment setting.
• The node makes HTTP requests to both the N8N Tools API and the official PayPal REST API endpoints.
• The PayPal environment can be set to either sandbox or live, affecting the base URL used for API calls.

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: Selecting an unsupported operation or resource results in an error.
• API Authentication Errors: If PayPal OAuth2 credentials are missing or expired, API calls will fail. Refresh tokens or reauthenticate as needed.
• Rate Limits or Quotas: The node tracks API credit usage; exceeding limits may cause failures.
• To resolve errors, verify credentials, input parameters (especially the dispute ID), and network connectivity.

Links and References

• PayPal Disputes API Documentation
• PayPal Developer Portal
• n8n Documentation