# PayPal

Adding PayPal as a payment gateway with the Funnelish Pay app is easy. After you create a gateway one time, you use it again on any number of funnels.

{% embed url="<https://www.youtube.com/watch?ab_channel=Funnelish&v=yoWpjE5_94g>" %}
Install a PayPal payment gateway
{% endembed %}

## Before you start

Make sure you:

* [Enable **Funnelish Pay**](https://docs.funnelish.com/start/collecting-payments), before you try adding a payment gateway.
* Add a [**payment form**](https://docs.funnelish.com/start/funnel-builder/editor-forms) to a funnel step.

{% hint style="info" %}
After you have created a gateway, you can use it again on any number of funnels.
{% endhint %}

## Create a gateway

1. Open a funnel step.
2. Click the payment form field.
3. In the left settings panel, click on **Edit payment** **options**.
4. Click **Connect a new gateway.**
5. In the pop-up window, click **PayPal**.

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FoynWuIf02E1cpYyzK1w9%2FPayPal.png?alt=media&#x26;token=16607815-3f8d-449a-b859-b7de414dc1ea" alt=""><figcaption><p>PayPal Gateway.</p></figcaption></figure>

6. On the new screen you can pick between PayPal and PayPal (new).&#x20;

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FOF5xYyAYaorBFDr9RMlg%2FScreenshot%202025-09-18%20at%2012.35.29.png?alt=media&#x26;token=eb871e19-f70c-4936-94d2-2c5a4d62354e" alt=""><figcaption><p>PayPal options</p></figcaption></figure>

## 1. Connect PayPal new (easier option):

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2F3vPbRwz80uprxJ5bONbw%2FScreenshot%202025-09-18%20at%2012.35.47.png?alt=media&#x26;token=7814deeb-ba02-48ed-8c0c-229c24194820" alt=""><figcaption><p>Connecting to PayPal new.</p></figcaption></figure>

1. You can enter your unique gateway name. This name is for internal use only.&#x20;
2. Click **Connect to PayPal** and finalise the process on PayPal's end.
3. Create gateway and save changes.

## 2. Connect PayPal (classic connection):

On the **New gateway** window:

1. **Enter your unique Gateway name. This name is for internal use, it is not visible in the funnel.**

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2F6o2fkoAUrSIDpRUs7qhw%2FScreenshot%202025-09-18%20at%2013.05.29.png?alt=media&#x26;token=4a08a72e-2b31-4321-8c57-2700336186b9" alt="" width="375"><figcaption><p>Configuring PayPal gateway</p></figcaption></figure>

{% hint style="warning" %}
You need to collect two keys from your PayPal account. To find that information, click the link below and log in to your PayPal account. &#x20;
{% endhint %}

2. **Go to:** [**https://developer.paypal.com/dashboard/applications/live**](https://developer.paypal.com/dashboard/applications/live)

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FylAOaLfCl6I3UZKOH1Rt%2FScreenshot%202025-09-18%20at%2012.46.54.png?alt=media&#x26;token=11a43540-f222-4fb7-9483-a95abe713f47" alt=""><figcaption></figcaption></figure>

3. Scroll down to the **App Name** heading.

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2F4145inkZu8TcioTKRgWn%2F2025-09-18_at_09.13.png?alt=media&#x26;token=4f2abe76-1470-40d2-b61f-299a5bc70a7c" alt=""><figcaption><p>Creating PayPal App.</p></figcaption></figure>

### App Name

If you see an API called **Default Application:**

1. Click that link to display the API credentials page.&#x20;
2. Come back to this article and scroll down to the [**API Credentials**](#credentials) section.

If you don't see a default application, click the **Create App** button. A new page will display.

1. Enter a unique name for the new API (e.g., Funnelish).
2. Click **Create App**. The API credentials page will display.&#x20;
3. Come back to this article and scroll down to the [this section.](#now-back-on-funnelish-side)

#### Now back on Funnelish side..

On the PayPal API credentials page:

1. Click the **Client ID** field to **copy the key.**
2. **Paste the key into the Client ID field.**
3. Go back to the PayPal page.
4. Click the **Show** link (under the Secret heading) to expand the **Secret** folder.
5. Copy the key and paste it into the **Secret** field.
6. Click create gateway and save your changes!&#x20;

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FXR04Ln4I3nivaKeQE45e%2F2025-09-18_at_09.13-1.png?alt=media&#x26;token=d3ce3c69-8293-4404-8838-bf792adb874c" alt=""><figcaption><p>Copy your client ID and Secret and paste them into Funnelish.</p></figcaption></figure>

{% hint style="danger" %}
Check that you added your PayPal credentials correctly:

* If doing **test** purchases: use your **sandbox credentials and enable test mode.**
* If doing **live** purchases: use your **real credentials.**

In both cases, make sure that you copied the whole client id and secret key and pasted it **without** pressing the *tab* key or adding extra spaces.
{% endhint %}

{% hint style="warning" %}
**UNCLAIMED PAYMENTS** - If you get a notification about unclaimed payments, please make sure your account is verified and you have a valid business account with a verified email.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.funnelish.com/start/collecting-payments/paypal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.