N8N Tools - PayPal EnhancedInstall

Overview

The node provides enhanced integration with PayPal's API, supporting over 70 operations across multiple PayPal resources. Specifically for the Reporting resource and the Show Transaction Details operation, it retrieves detailed information about a specific transaction by its ID.

This is useful in scenarios where you need to audit or analyze individual PayPal transactions, such as verifying payment details, checking transaction status, or reconciling financial records.

Practical example:
You have an order processing workflow and want to fetch detailed information about a particular PayPal transaction to confirm payment success and retrieve metadata like payer info, amounts, fees, and timestamps.

Properties

Note: For the Show Transaction Details operation, only the ID and Environment options are relevant; pagination and time filters apply to listing operations.

Output

The node outputs a JSON object containing:

• resource: The resource name, here "reporting".
• operation: The operation performed, here "showTransactionDetails".
• success: Boolean indicating if the operation succeeded.
• All fields returned by PayPal's /v1/reporting/transactions/{transaction_id} endpoint, which typically include transaction details such as:
  • Transaction ID
  • Status
  • Payer and payee information
  • Amounts and currency
  • Fees
  • Transaction timestamps
  • Related invoice or order IDs (if any)
• creditsUsed: Number of API credits consumed by the request (usually 1).
• creditsRemaining: Remaining API credits after the request.
• timestamp: ISO string timestamp when the data was retrieved.

No binary data output is produced by this operation.

Dependencies

• Requires valid credentials for:
  • An API key credential to access the intermediary validation service.
  • A PayPal OAuth2 token credential for authenticating requests to PayPal's API.
• The node uses the PayPal REST API endpoints, switching between sandbox and live environments based on user selection.
• No additional external dependencies beyond these credentials and network access to PayPal APIs.

Troubleshooting

• Common issues:

  • Invalid or expired PayPal OAuth2 token causing authentication failures.
  • Incorrect transaction ID leading to "Not Found" errors from PayPal.
  • Network connectivity issues preventing API calls.
  • Invalid JSON in optional request body (not applicable for this operation but relevant for others).

• Error messages:

  • "N8N Tools API validation failed": Indicates failure in validating the requested resource and operation via the intermediary API. Check API key and permissions.
  • "Unknown reporting operation: showTransactionDetails": Should not occur if configured correctly; indicates internal mismatch.
  • "PayPal Enhanced operation failed: <message>": Generic error wrapper; check inner message for details.
  • "Invalid JSON in request body: <error>": Not applicable here but important for other operations requiring JSON input.

• Resolutions:

  • Ensure credentials are up to date and have required scopes.
  • Verify the transaction ID exists and is correct.
  • Confirm network access to PayPal endpoints.
  • Use sandbox environment for testing before switching to live.

Links and References

• PayPal Reporting Transactions API
• PayPal Developer Documentation
• ISO 8601 Date Format