> ## Documentation Index
> Fetch the complete documentation index at: https://funnelfox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# PayPal payment integration

> Set up PayPal as a payment method in FunnelFox. Enable PayPal checkout, subscriptions, and one-click payments in your funnels.

PayPal integration enables you to accept payments from millions of PayPal users
worldwide. With strong brand recognition and buyer protection, PayPal can
significantly increase conversion rates for certain demographics and regions.

## Features

### Payment Methods

* **PayPal Wallet** - Direct PayPal account payments
* **PayPal Credit** - Buy now, pay later (US)
* **Venmo** - Popular with younger US demographics
* **Guest Checkout** - Cards without PayPal account

### Subscription Features

* Basic recurring billing
* Subscription plans
* Plan switching (upgrades/downgrades)
* Cancellation management

### Key Benefits

* Trusted by consumers globally
* One-click payments for returning users
* Buyer and seller protection
* No card details shared with merchant

## Configuration

### Prerequisites

* PayPal Business account
* API credentials (Client ID and Secret)
* Webhooks enabled
* Products/plans created in PayPal

### Setup Steps

<Steps>
  <Step title="Get API Credentials">
    1. Log into [PayPal Developer Dashboard](https://developer.paypal.com)
    2. Navigate to **My Apps & Credentials**
    3. Select or create an app
    4. Copy **Client ID**
    5. Copy **Secret** (click Show)

    For sandbox testing:

    1. Switch to **Sandbox** tab
    2. Use sandbox credentials
    3. Create test accounts for testing

    <Warning>
      Keep your Secret key secure. Never expose it in client-side code
      or public repositories.
    </Warning>
  </Step>

  <Step title="Configure in FunnelFox">
    1. Go to **Integrations** → **PayPal**
    2. Select **PayPal**
    3. Enter Client ID
    4. Enter Secret
    5. Choose environment (Sandbox/Live)
    6. Click **Save**
  </Step>

  <Step title="Webhook Configuration">
    FunnelFox automatically registers webhooks for:

    * Payment capture completed
    * Subscription activated
    * Subscription cancelled
    * Subscription suspended
    * Payment sale completed

    Webhook URL created:

    ```
    https://api.funnelfox.com/webhooks/paypal/[project-id]
    ```
  </Step>

  <Step title="Product Setup">
    For subscriptions, create plans in PayPal:

    1. Go to [PayPal Dashboard](https://www.paypal.com/billing/plans)
    2. Click **Create Plan**
    3. Set pricing and billing cycle
    4. Activate the plan
    5. Plans sync to FunnelFox automatically
  </Step>
</Steps>

## Subscription Management

### Creating Plans

In PayPal Dashboard:

```
Plan Name: Premium Monthly
Price: $19.99/month
Billing Cycle: Monthly
Trial: Optional (set days and price)
Setup Fee: Optional
```

### Subscription Limitations

<Warning>
  PayPal subscriptions have limitations compared to other PSPs:

  * **No pause/resume** - Only cancel is supported
  * **No deferred benefits** - Unused time is lost
  * **Limited trials** - Basic trial support only
  * **Plan changes** - Require cancellation and new subscription
</Warning>

### Managing Subscriptions

Available operations:

* **Cancel** - Immediate or at period end
* **Suspend** - Temporarily stop charging
* **Reactivate** - Resume suspended subscription
* **Update** - Limited to payment method

## Checkout Experience

### PayPal Button

The familiar PayPal button:

* Instantly recognized
* Builds trust
* One-click for returning users
* Opens PayPal login window

### Guest Checkout

Allow non-PayPal users:

* Pay with credit/debit cards
* No PayPal account required
* Still processed by PayPal
* Optional - can be disabled

<Note>
  Guest checkout availability varies by country and buyer's purchase
  history. PayPal determines eligibility automatically.
</Note>

## Express Checkout

Speed up purchases with PayPal One Touch:

1. User logs into PayPal once
2. Stays logged in across sites
3. One-click purchases thereafter
4. No password on each purchase

Dramatically increases conversion for repeat buyers.

## Testing

### Sandbox Environment

Test with sandbox accounts:

<Steps>
  <Step title="Create Test Accounts">
    1. Go to [PayPal Developer](https://developer.paypal.com/developer/accounts)
    2. Create buyer account (personal)
    3. Create seller account (business)
    4. Note email and password for each
  </Step>

  <Step title="Test Payments">
    1. Use sandbox credentials in FunnelFox
    2. Log in with test buyer account
    3. Complete purchase flow
    4. Check sandbox notifications
  </Step>
</Steps>

### Test Scenarios

Test these flows:

* Successful payment
* Cancelled payment (close PayPal window)
* Insufficient funds
* Subscription creation
* Subscription cancellation

## Regional Considerations

### Strong Markets

PayPal is particularly popular in:

* **United States** - 50%+ have accounts
* **United Kingdom** - Widely trusted
* **Germany** - Preferred payment method
* **Australia** - High adoption rate

### Payment Methods by Country

| Country   | PayPal Credit | Venmo | Guest Checkout |
| --------- | ------------- | ----- | -------------- |
| US        | ✅             | ✅     | ✅              |
| UK        | ❌             | ❌     | ✅              |
| Germany   | ❌             | ❌     | ✅              |
| Australia | ❌             | ❌     | ✅              |

## Integration Methods

### Direct Integration

Using PayPal directly:

* Full PayPal features
* Direct relationship
* PayPal fees apply
* Separate reconciliation

### Via Other PSPs

PayPal through other providers:

* **Stripe** - Available for EU accounts
* **FunnelFox Billing** - Unified management

<Info>
  If you're already using Stripe (EU), you might not need
  separate PayPal integration. Check your existing PSP's PayPal support.
</Info>

## Fees and Pricing

PayPal transaction fees:

* **Domestic** - 2.9% + \$0.30 (US)
* **International** - 4.4% + fixed fee
* **Micropayments** - 5% + $0.05 (under $10)
* **Nonprofit** - Discounted rates available

No monthly fees for standard accounts.

## Common Issues

<AccordionGroup>
  <Accordion title="PayPal button not showing">
    * Verify Client ID is correct
    * Check JavaScript isn't blocked
    * Ensure HTTPS is enabled
    * Clear browser cache
  </Accordion>

  <Accordion title="Guest checkout not available">
    * Not available in all countries
    * Buyer history affects availability
    * Can be disabled by PayPal
    * Try different test account
  </Accordion>

  <Accordion title="Webhooks not received">
    * Check webhook URL in PayPal
    * Verify webhook ID is correct
    * Ensure endpoint is accessible
    * Review PayPal webhook logs
  </Accordion>

  <Accordion title="Subscription plans not syncing">
    * Plans must be active in PayPal
    * Check API permissions
    * Verify billing agreement enabled
    * Wait up to 5 minutes for sync
  </Accordion>
</AccordionGroup>

## Optimization Tips

### Increase Conversions

* **Show PayPal prominently** - Many users look for it
* **Enable guest checkout** - Don't force PayPal accounts
* **Use Express Checkout** - Reduce friction
* **Display buyer protection** - Build trust

### Reduce Abandonment

* Clear PayPal fees disclosure
* Show security badges
* Explain redirect to PayPal
* Provide customer support

### Mobile Optimization

* PayPal optimized for mobile
* In-context checkout available
* Biometric authentication
* Saved payment methods

## Limitations

### Compared to Card Processing

**Less Control**

* Redirects to PayPal
* Limited checkout customization
* PayPal branding required
* Can't fully white-label

**Fewer Features**

* Basic subscription management
* Limited retry logic
* No advanced dunning
* Minimal analytics

**Customer Ownership**

* PayPal owns relationship
* Limited customer data
* PayPal handles disputes
* Restricted email access

## Best Practices

### Positioning

* Offer alongside cards, not instead
* Highlight for international customers
* Emphasize buyer protection
* Show for returning customers

### Communication

* Explain PayPal redirect
* Set clear expectations
* Provide PayPal support info
* Handle disputes promptly

### Technical

* Always use HTTPS
* Implement proper error handling
* Log all transactions
* Monitor webhook failures

## Next Steps

* [Add checkout element](/elements/checkout) with PayPal
* [Create subscription plans](https://www.paypal.com/billing/plans) in PayPal
* [Test payment flows](/billing/testing) in sandbox