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

# Integrate PayPal

> Generate PayPal API credentials and connect them to FreshLimePay Cloud.

This guide walks you step by step through creating PayPal Live API credentials and connecting them to FreshLimePay Cloud.

You will be ready to accept real PayPal payments by the end of this guide.

<Note>
  A PayPal <strong>Business</strong>
  account is required to generate API credentials and accept payments.
</Note>

## 1. Access the PayPal Developer Dashboard

Go to the official PayPal Developer portal to begin setting up your API credentials.

[Open PayPal Developer Dashboard](https://developer.paypal.com/dashboard)

![PayPal Developer Dashboard](https://cloud.freshlimepay.com/Assets/Images/paypal_dashboard_developer.png)

## 2. Choose the Correct Environment

Select the environment where you want to create your credentials:

* **Sandbox** - for testing and development
* **Live** - for processing real transactions

For this guide, we will generate **Live** credentials.

![Ensure Live PayPal Mode](https://cloud.freshlimepay.com/Assets/Images/ensure_live_paypal_mode.png)

## 3. Create a New REST API App

1. Click **Apps & Credentials**\\

   ![Apps and Credentials](https://cloud.freshlimepay.com/Assets/Images/paypal_apps_and_credentials.png)
2. Click **Create App**\\

   ![Create PayPal App](https://cloud.freshlimepay.com/Assets/Images/create_app_paypal.png)
3. Enter a name for your app\
   Example: **FreshLimePay Cloud Live App**\\

   ![Create App Name](https://cloud.freshlimepay.com/Assets/Images/create_app_test.png)
4. Review your app settings\\

   ![App Settings](https://cloud.freshlimepay.com/Assets/Images/settings_app_paypal.png)
5. Enable **Transaction Search**\
   This permission allows FreshLimePay Cloud to sync your latest transaction data.\\

   ![Enable Transaction Search](https://cloud.freshlimepay.com/Assets/Images/enable_transaction_search.png)

## 4. Copy Your Client ID and Secret

Once the app is created, your credentials will be visible immediately.

* Client ID
* Secret

![Copy Client ID and Secret](https://cloud.freshlimepay.com/Assets/Images/copy_client_id_secret_id.png)

<Note>
  Keep your Secret private. Never expose it publicly.
</Note>

## 5. Add Your Credentials to FreshLimePay Cloud

### Sign in

Sign in to FreshLimePay Cloud using your Google account.

![Sign in with Google](https://cloud.freshlimepay.com/Assets/Images/sign_up_google.png)

### Update PayPal settings

Go to your PayPal settings page:

[https://cloud.freshlimepay.com/get-started/update-settings](https://cloud.freshlimepay.com/get-started/update-settings)

![Update PayPal Credentials](https://cloud-cdn.freshlimepay.com/Images/configure_paypal_settings.png)

Paste your **Client ID** and **Secret**, then click **Update**.

### Start accepting payments

After connecting:

* Add products for one-time or subscription payments
* Generate checkout buttons or links
* Embed them on your site or app

![Add Product Payment](https://cloud.freshlimepay.com/Assets/Images/dashboard_add_product_payment.png)

You can now accept PayPal payments directly into your account.

## What's next?

<Card title="Create your first PayPal button" icon="credit-card" href="/guides/connect-pay-pal/create-one-time-payment-button">
  Set up a one-time PayPal checkout button and embed it directly on your website or app.
</Card>

<Card title="Create your recurring PayPal button" icon="shield-check" href="/guides/connect-pay-pal/create-recurring-payment-button">
  Create subscription-based PayPal buttons for recurring payments with secure, automatic payouts.
</Card>