Actions55
- Webhooks Actions
- Payments Actions
- Products Actions
- Plans Actions
- Partner Referrals Actions
- Reporting Actions
- Orders Actions
- Subscriptions Actions
- Invoicing Actions
- Disputes Actions
Partner Referrals → Show Referral Details
AI-generatedOverview
The node "N8N Tools - PayPal Enhanced" provides a comprehensive integration with PayPal's API, supporting over 70 operations across multiple PayPal resources. Specifically for the Partner Referrals resource and the Show Referral Details operation, this node retrieves detailed information about a specific partner referral by its ID.
This operation is useful in scenarios where you need to programmatically access the status or details of a partner referral within your PayPal partner management workflows. For example, after creating a partner referral, you might want to check its current state or retrieve additional metadata for reporting or automation purposes.
Practical examples:
- Automatically fetch referral details after creation to log or notify stakeholders.
- Integrate referral status checks into a CRM or partner management system.
- Use referral data to trigger conditional workflows based on referral approval or rejection.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the partner referral whose details you want to retrieve. |
| Additional Options | Optional parameters including: |
| - Environment: Choose between "Sandbox" (test) or "Live" (production) PayPal environment. | |
| - Page Size: Number of items per page for list operations (not typically used for this op). | |
| - Start Time: Filter start date/time in ISO 8601 format (not typically used for this op). | |
| - End Time: Filter end date/time in ISO 8601 format (not typically used for this op). |
Output
The output JSON object includes:
resource: The resource name, here always"partnerReferrals".operation: The operation performed, here"showReferralDetails".success: Boolean indicating if the operation succeeded.- All fields returned by the PayPal API for the partner referral details, which may include referral status, partner info, timestamps, and other metadata.
creditsUsed: Number of API credits consumed by the request (from the external validation API).creditsRemaining: Remaining API credits available.timestamp: The ISO timestamp when the response was received.
The node does not output binary data for this operation.
Dependencies
- Requires an API key credential for the external "N8N Tools API" service that validates operations and tracks usage.
- Requires a PayPal OAuth2 API credential providing an access token and environment configuration (sandbox or live).
- The node makes HTTP requests to both the N8N Tools API and the PayPal 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 will throw an error. Ensure JSON syntax correctness.
- Validation Failure: If the external validation API rejects the operation, the node throws an error indicating validation failure. Check API key validity and operation/resource correctness.
- Unknown Operation or Resource: If an unsupported operation or resource is specified, the node throws an error. Verify that the operation "showReferralDetails" is selected under the "Partner Referrals" resource.
- Authorization Errors: If PayPal OAuth2 credentials are invalid 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. Monitor usage and adjust accordingly.