Actions55
- Webhooks Actions
- Payments Actions
- Products Actions
- Plans Actions
- Partner Referrals Actions
- Reporting Actions
- Orders Actions
- Subscriptions Actions
- Invoicing Actions
- Disputes Actions
Disputes → List Disputes
AI-generatedOverview
This node provides enhanced integration with PayPal, supporting a wide range of operations across multiple PayPal resources. Specifically for the Disputes resource and the List Disputes operation, it allows users to retrieve a list of customer disputes (such as chargebacks or claims) from their PayPal account.
Typical use cases include:
- Monitoring and managing disputes automatically within workflows.
- Fetching dispute data for reporting or further processing.
- Filtering disputes by date ranges or controlling pagination to handle large datasets.
For example, a merchant could use this node to regularly pull all recent disputes from their PayPal sandbox or live environment, then trigger alerts or update internal systems accordingly.
Properties
| Name | Meaning |
|---|---|
| Additional Options | Collection of optional parameters: • Environment: Choose between "Sandbox" or "Live" PayPal environments. • Page Size: Number of disputes to return per page (default 20). • Start Time: ISO 8601 formatted start date/time to filter disputes. • End Time: ISO 8601 formatted end date/time to filter disputes. |
Output
The node outputs an array of JSON objects, each representing the result of the List Disputes operation. Each output item includes:
resource: The resource name, here always"disputes".operation: The operation performed, here"listDisputes".success: Boolean indicating if the API call was successful.- All fields returned by the PayPal API for disputes listing, such as dispute details.
creditsUsed: Number of API credits consumed by the request (usually 1).creditsRemaining: Remaining API credits after the request.timestamp: ISO timestamp when the data was fetched.
If the node encounters an error and is set to continue on failure, it outputs an object with success: false and an error message describing the issue.
The node does not output binary data.
Dependencies
- Requires valid credentials for:
- An API key credential for the external "N8N Tools API" used for validation.
- A PayPal OAuth2 access token credential with environment info (sandbox/live) and client ID.
- 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 operation.
Troubleshooting
- Invalid JSON in Request Body: If a JSON input property is malformed, the node throws an error specifying invalid JSON. Ensure JSON syntax correctness.
- API Validation Failure: If the initial validation call to the external API fails, the node will throw an error indicating validation failure. Check API key validity and network connectivity.
- Unknown Operation or Resource: Selecting an unsupported operation or resource triggers an error. Verify that the selected operation matches the resource.
- Authorization Errors: If PayPal OAuth2 tokens are expired or invalid, API calls will fail. Refresh or reauthenticate credentials.
- Rate Limits / Credits: The node tracks API credits used and remaining; hitting limits may cause failures. Monitor usage and adjust workflow frequency accordingly.
Links and References
This summary focuses exclusively on the Disputes resource and the List Disputes operation as requested.