---
title: How to Connect PayPal to OneSuite
description: "Connect PayPal so your clients can pay invoices online with PayPal. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the PayPal card. Paste the **Client ID** and **Secret** from your PayPal REST app, choose a **Currency**, and click **Save**. **In this guide you'll learn how to:** - Find your PayPal Client…"
url: "https://help.onesuite.io/docs/how-to-connect-paypal-to-onesuite/"
updated: "2026-11-18"
category: Payment Integration
---

# How to Connect PayPal to OneSuite

Connect PayPal so your clients can pay invoices online with PayPal. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the PayPal card. Paste the **Client ID** and **Secret** from your PayPal REST app, choose a **Currency**, and click **Save**.

**In this guide you'll learn how to:**

- Find your PayPal Client ID and Secret
- Connect PayPal to OneSuite
- Avoid mixing Live and Sandbox credentials
- Switch PayPal on for an invoice

## Before you start

- You need a PayPal account with access to the PayPal Developer Dashboard.
- You need access to **Settings**. If you can't see **Integrations**, ask an admin.
- A REST app is the app in PayPal that holds your credentials. Your credentials are your Client ID and Secret. They are codes that let OneSuite work with your PayPal account.
- Live and Sandbox apps have different credentials. Live takes real payments. Sandbox is a test mode.
- Decide which app OneSuite should use. Then take both values from that one app.

## What does OneSuite ask for when you connect PayPal?

| Field | Where to find it | Required |
| --- | --- | --- |
| **Client ID** | In the PayPal Developer Dashboard, open **Apps & Credentials**, then choose your REST app. | Yes |
| **Secret** | In the same REST app. | Yes |
| **Currency** | Starts as **US Dollar (USD)**. OneSuite uses it when an invoice has no currency of its own. | No |

## How do I connect PayPal to OneSuite?

1. Click your name at the bottom of the sidebar, then click **Settings**.
2. Under **Integrations**, click **Payment**.
3. On the **Payment Methods** page, find **PayPal** and click **Connect**.
4. In the PayPal Developer Dashboard, open **Apps & Credentials**.
5. Choose your REST app.
6. Copy the Client ID.
7. Paste it into **Client ID** in OneSuite.
8. Copy the secret.
9. Paste it into **Secret** in OneSuite.
10. Check the **Currency**.
11. Click **Save**.

![](https://help.onesuite.io/wp-content/uploads/2026/11/open-payment-settings-in-onesuite-1-925x1024.png)

## How do I check if it worked?

The PayPal card on the **Payment Methods** page now says **Connected** instead of **Not connected**. You also see PayPal marked **Connected** under **Invoices** > **Configure** > **Getting paid** > **Online payments**.

OneSuite switches a connected gateway on for every new invoice. An invoice you created earlier keeps its own choice. To use PayPal on an older invoice:

1. Open the invoice.
2. Switch PayPal on in its **Payments** panel.
3. Save the invoice and send it again.

## FAQs

### Which PayPal credentials does OneSuite need?

A Client ID and a Secret. Both come from the same REST app, under **Apps & Credentials** in the PayPal Developer Dashboard. PayPal's [guide to REST API credentials](https://www.paypal.com/us/cshelp/article/how-do-i-create-paypal-rest-api-credentials-ts1949) shows how to create an app.

### Why do my PayPal credentials not work?

Check that your Client ID and Secret come from the same app. If one is from a Live app and the other is from a Sandbox app, they will not match.

### Does PayPal need a webhook in OneSuite?

No. A webhook is how a gateway tells OneSuite about a payment. The PayPal dialog shows no webhook URL, so you have nothing to add in PayPal.

## What to do next

**See every gateway:** Browse all the guides in [Payment Integration](https://help.onesuite.io/docs-category/payment-integration/).

**Record the money that arrives:** Log payments made outside a gateway with [How to Record Invoice Payments](https://help.onesuite.io/docs/how-to-record-invoice-payments/).
