N8N Tools - PayPal Enhanced

Complete PayPal integration with 70+ operations covering the full PayPal ecosystem. This N8N community node provides comprehensive access to Orders, Subscriptions, Invoicing, Disputes, Webhooks, Partner management, and Reporting APIs that are missing from the official PayPal node.

✨ Features

• 🛒 Complete Orders API: Create, update, authorize, capture, and track orders with full lifecycle management
• 💳 Advanced Subscriptions: Full billing plan and subscription management with trial periods and discounts
• 🧾 Professional Invoicing: Create, send, track, and manage invoices with automated reminders
• ⚖️ Dispute Management: Handle disputes, chargebacks, and claims with evidence submission
• 🔔 Webhook Management: Create, update, and test webhooks for real-time notifications
• 💰 Payment Operations: Comprehensive payment processing, refunds, and transaction details
• 📦 Product Catalog: Manage subscription products and services
• 📋 Billing Plans: Create flexible recurring billing with multiple pricing tiers
• 🤝 Partner Referrals: Manage partner onboarding and referral programs
• 📊 Advanced Reporting: Transaction history, balance information, and detailed analytics
• 🔒 Secure API: Powered by N8N Tools platform with usage tracking and validation

🚀 Quick Start

Installation

Install this node in your N8N instance:

Via Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your N8N interface
2. Click Install a community node
3. Enter n8n-nodes-n8ntools-paypal-enhanced
4. Click Install

Via npm

npm install n8n-nodes-n8ntools-paypal-enhanced

Setup Credentials

1. Sign up at N8N Tools and get your API key
2. In N8N, create new N8N Tools API credentials
3. Enter your API URL: https://api.n8ntools.io
4. Enter your API key

📋 Available Resources

🛒 Orders (7 Operations)

Complete order lifecycle management beyond the official node:

💳 Subscriptions (7 Operations)

Full recurring billing capabilities missing from official node:

• Create Subscription: Set up recurring payments with trial periods
• Show Subscription Details: Get detailed subscription information
• Update Subscription: Modify subscription terms and pricing
• Suspend Subscription: Temporarily pause billing
• Cancel Subscription: Permanently end subscription
• Activate Subscription: Resume suspended subscriptions
• Get Subscription Transactions: View all subscription payments

📦 Products (4 Operations)

Manage subscription products and services:

• Create Product: Define products for subscriptions
• Show Product Details: Get product information
• Update Product: Modify product details
• List Products: View all available products

📋 Plans (4 Operations)

Advanced billing plan management:

• Create Plan: Set up billing plans with multiple pricing tiers
• Show Plan Details: Get plan configuration
• Update Plan: Modify billing plan settings
• List Plans: View all billing plans

🧾 Invoicing (10 Operations)

Professional invoicing system not available in official node:

• Create Draft Invoice: Create invoice drafts
• Show Invoice Details: Get comprehensive invoice info
• Update Invoice: Modify draft invoices
• Delete Invoice: Remove draft invoices
• Send Invoice: Send invoices to customers
• Cancel Invoice: Cancel sent invoices
• Send Reminder: Send payment reminders
• List Invoices: View all invoices with filtering
• Search Invoices: Advanced invoice search
• Generate Invoice Number: Auto-generate invoice numbers

⚖️ Disputes (8 Operations)

Complete dispute management system:

• List Disputes: View all disputes with filtering
• Show Dispute Details: Get detailed dispute information
• Update Dispute: Provide dispute updates
• Escalate to Claim: Escalate disputes to claims
• Accept Offer: Accept resolution offers
• Accept Claim: Accept liability for claims
• Provide Evidence: Submit evidence for disputes
• Provide Supporting Info: Add supporting documentation

🔔 Webhooks (7 Operations)

Full webhook management capabilities:

• Create Webhook: Set up event notifications
• Show Webhook Details: Get webhook configuration
• Update Webhook: Modify webhook settings
• Delete Webhook: Remove webhooks
• List Webhooks: View all configured webhooks
• List Event Subscriptions: See subscribed events
• Simulate Event: Test webhook endpoints

💰 Payments (3 Operations)

Enhanced payment processing:

• Show Payment Details: Get comprehensive payment info
• Refund Payment: Process full or partial refunds
• Show Refund Details: Get refund transaction details

🤝 Partner Referrals (2 Operations)

Partner program management:

• Create Partner Referral: Onboard new partners
• Show Referral Details: Track referral status

📊 Reporting (3 Operations)

Advanced reporting and analytics:

• List Transactions: Get transaction history with filtering
• Show Transaction Details: Detailed transaction information
• Get Balance: Account balance and available funds

💡 Usage Examples

Create Complete Order with Tracking

// Configuration
Resource: "Orders"
Operation: "Create Order"
Request Body: {
  "intent": "CAPTURE",
  "purchase_units": [{
    "amount": {
      "currency_code": "USD",
      "value": "100.00"
    },
    "description": "Premium Service Package"
  }],
  "application_context": {
    "return_url": "https://example.com/return",
    "cancel_url": "https://example.com/cancel"
  }
}

// Output
{
  "resource": "orders",
  "operation": "createOrder",
  "success": true,
  "id": "5O190127TN364715T",
  "status": "CREATED",
  "links": [{
    "href": "https://api.paypal.com/v2/checkout/orders/5O190127TN364715T",
    "rel": "self",
    "method": "GET"
  }],
  "creditsUsed": 1,
  "creditsRemaining": 99
}

Set Up Recurring Subscription

// Step 1: Create Product
Resource: "Products"
Operation: "Create Product"
Request Body: {
  "name": "Premium Membership",
  "type": "SERVICE",
  "category": "SOFTWARE"
}

// Step 2: Create Billing Plan
Resource: "Plans"  
Operation: "Create Plan"
Request Body: {
  "product_id": "PROD-12345",
  "name": "Monthly Premium Plan",
  "billing_cycles": [{
    "frequency": {
      "interval_unit": "MONTH",
      "interval_count": 1
    },
    "tenure_type": "REGULAR",
    "sequence": 1,
    "total_cycles": 0,
    "pricing_scheme": {
      "fixed_price": {
        "value": "29.99",
        "currency_code": "USD"
      }
    }
  }],
  "payment_preferences": {
    "auto_bill_outstanding": true
  }
}

// Step 3: Create Subscription
Resource: "Subscriptions"
Operation: "Create Subscription"
Request Body: {
  "plan_id": "P-12345",
  "subscriber": {
    "email_address": "customer@example.com",
    "name": {
      "given_name": "John",
      "surname": "Doe"
    }
  },
  "application_context": {
    "return_url": "https://example.com/return",
    "cancel_url": "https://example.com/cancel"
  }
}

Professional Invoice Management

// Create and Send Invoice
Resource: "Invoicing"
Operation: "Create Draft Invoice"
Request Body: {
  "detail": {
    "invoice_number": "INV-2024-001",
    "currency_code": "USD"
  },
  "invoicer": {
    "name": {
      "given_name": "John",
      "surname": "Doe"
    },
    "email_address": "john@business.com"
  },
  "primary_recipients": [{
    "billing_info": {
      "email_address": "customer@example.com"
    }
  }],
  "items": [{
    "name": "Consulting Services",
    "description": "Monthly consulting retainer",
    "quantity": "1",
    "unit_amount": {
      "currency_code": "USD",
      "value": "500.00"
    }
  }]
}

// Then send the invoice
Resource: "Invoicing"
Operation: "Send Invoice"
ID: "INV2-XXXX-XXXX-XXXX"

Handle Disputes with Evidence

// Provide Evidence for Dispute
Resource: "Disputes"
Operation: "Provide Evidence"
ID: "PP-D-12345"
Request Body: {
  "evidence_type": "PROOF_OF_DELIVERY",
  "evidence_info": {
    "tracking_info": [{
      "carrier_name": "UPS",
      "tracking_number": "1Z999AA1234567890"
    }]
  },
  "notes": "Package was delivered and signed for by recipient"
}

Real-time Webhook Setup

// Create Webhook for Payment Events
Resource: "Webhooks"
Operation: "Create Webhook"
Request Body: {
  "url": "https://example.com/webhooks/paypal",
  "event_types": [
    {"name": "PAYMENT.CAPTURE.COMPLETED"},
    {"name": "PAYMENT.CAPTURE.DENIED"},
    {"name": "BILLING.SUBSCRIPTION.ACTIVATED"}
  ]
}

⚙️ Configuration Options

Environment Settings

• Sandbox: Testing environment (default)
• Live: Production environment

Pagination Controls

• Page Size: Number of items per page (1-100, default: 20)
• Start Time: Filter by start date (ISO 8601 format)
• End Time: Filter by end date (ISO 8601 format)

Advanced Request Options

• Request Body: JSON payload for create/update operations
• ID: Resource identifier for show/update/delete operations
• Additional Options: Environment, pagination, and filtering options

🛠️ Example Workflows

E-commerce Order Processing

[Order Created] → [PayPal Enhanced: Create Order] → [Customer Redirected] → [PayPal Enhanced: Capture Payment] → [Order Fulfillment]

Subscription Business

[Customer Signup] → [PayPal Enhanced: Create Product] → [PayPal Enhanced: Create Plan] → [PayPal Enhanced: Create Subscription] → [Customer Onboarded]

Professional Services Billing

[Service Completed] → [PayPal Enhanced: Create Invoice] → [PayPal Enhanced: Send Invoice] → [Payment Tracking] → [Send Reminder if Overdue]

Dispute Management

[Webhook: Dispute Created] → [PayPal Enhanced: Show Dispute] → [Gather Evidence] → [PayPal Enhanced: Provide Evidence] → [Resolution Tracking]

📊 Comparison with Official PayPal Node

🔧 API Endpoints

All operations are routed through N8N Tools API for consistent authentication and usage tracking:

🚨 Error Handling

The node provides comprehensive error handling with detailed messages:

{
  "error": "INVALID_RESOURCE_ID",
  "success": false,
  "resource": "orders",
  "operation": "showOrderDetails",
  "details": {
    "issue": "The specified resource ID does not exist",
    "field": "id",
    "value": "INVALID_ORDER_ID"
  }
}

💸 Pricing & Limits

• Standard Operations: 1 credit per API call
• Complex Operations: 2-3 credits (subscriptions, invoicing, disputes)
• List Operations: 1 credit per page
• Monthly Quotas: Based on your N8N Tools subscription plan
• Rate Limits: Based on your subscription tier
• Usage Tracking: Real-time credit monitoring

🔧 Troubleshooting

Common Issues

Authentication Errors

• Verify N8N Tools API key is valid and active
• Check API URL is set to https://api.n8ntools.io
• Ensure sufficient credits in your account

Invalid Request Body

• Validate JSON syntax in request body
• Check PayPal API documentation for required fields
• Use sandbox environment for testing

Resource Not Found

• Verify resource ID exists and is accessible
• Check environment setting (sandbox vs live)
• Ensure proper permissions for the operation

Webhook Issues

• Verify webhook URL is publicly accessible
• Check SSL certificate is valid
• Ensure endpoint handles PayPal webhook format

📈 Performance Tips

1. Batch Operations: Use list operations with pagination for bulk data
2. Caching: Cache frequently accessed data like product catalogs
3. Environment Management: Use sandbox for development and testing
4. Error Handling: Implement retry logic for transient failures
5. Webhook Optimization: Use webhooks for real-time updates instead of polling

🆘 Support

• Documentation: docs.n8ntools.io
• API Reference: api.n8ntools.io/docs
• Community: Discord
• Email: support@n8ntools.io

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by N8N Tools