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

# Connect PayPal to Vortex IQ

> Connect PayPal to Vortex IQ to include transaction data in payment performance reports, revenue leakage analysis, and Vortex Mind cross-platform diagnostics.

Connecting PayPal allows Vortex IQ to include PayPal transaction data alongside your other payment gateways. Vortex Mind can then compare auth rates, refund rates, and dispute patterns across Stripe, PayPal, and any other connected payment processor-giving you a unified view of payment health rather than a per-gateway silo.

## What Vortex IQ reads from PayPal

| Data type                                      | Used by                                                               |
| ---------------------------------------------- | --------------------------------------------------------------------- |
| Transaction records (sales, refunds, disputes) | Vortex Mind - Payment Performance Intelligence, Daily Revenue Leakage |
| Decline and void records                       | Vortex Mind - Decline Recovery Intelligence                           |
| Checkout abandonment signals                   | Vortex Mind - Checkout Conversion Failure                             |
| Payout and fee data                            | Vortex Mind - Daily Revenue Leakage                                   |

## How to connect

<Steps>
  <Step title="Go to Connected Sources">
    Navigate to **Settings → Connected Sources** and click **Add Source**.
  </Step>

  <Step title="Select PayPal">
    Search for "PayPal" and select it from the catalogue.
  </Step>

  <Step title="Authorise via OAuth">
    Click **Connect**. You will be redirected to PayPal to log in and grant Vortex IQ read access to your transaction history. No write permissions are requested.
  </Step>

  <Step title="Select accounts">
    If you manage multiple PayPal accounts, select which ones to import.
  </Step>

  <Step title="Save">
    Click **Save**. The initial data pull begins. Vortex Mind reports that include PayPal data will reflect it on the next scheduled report run.
  </Step>
</Steps>

<Note>
  Vortex IQ requests **read-only** access to PayPal transaction data. It cannot initiate refunds, moves funds, or change your PayPal account settings.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth redirect fails">
    Ensure you are logged into the PayPal account with admin/owner access before clicking Connect. Sub-user accounts may not have sufficient permissions.
  </Accordion>

  <Accordion title="Historical data not appearing">
    PayPal's API returns up to 3 years of transaction history. The initial pull may take up to 30 minutes for accounts with high transaction volume.
  </Accordion>

  <Accordion title="Token expired">
    PayPal OAuth tokens expire periodically. Reconnect via **Settings → Connected Sources → PayPal → Reconnect**.
  </Accordion>
</AccordionGroup>