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

# PayPal Setup

> Configure PayPal payments in PCI Booking. API credentials, webhook setup, and testing.

**Requires:** Verified [PayPal Business](https://www.paypal.com/business) account.

PayPal allows customers to pay using their PayPal balance, linked bank accounts, or cards stored in their PayPal account. Through PCI Booking's [Payments Library](/payments-library/overview), PayPal is offered alongside card payments and other methods on the same checkout page.

## How PayPal Works with PCI Booking

When a customer selects PayPal at checkout, the Payments Library opens a PayPal authorization window. The customer logs in to their PayPal account, selects a funding source, and authorizes the payment. Once authorized, PCI Booking completes the charge and notifies your system. No payment credentials pass through your servers.

PayPal supports **CHARGE** operations only. Tokenization and 3D Secure are not applicable to PayPal transactions.

## Prerequisites

* A verified [PayPal Business](https://www.paypal.com/business) account
* A PCI Booking merchant account

## 1. Access Developer Dashboard

1. Go to the [PayPal Developer Dashboard](https://developer.paypal.com/dashboard/).
2. Sign in with your PayPal Business account.

## 2. Create an App

1. Navigate to **Apps & Credentials**.
2. Select **Live** (or **Sandbox** for testing).
3. Click **Create App**.
4. Enter a name and select **Merchant** as the app type.
5. Click **Create App**.

## 3. Copy Credentials

* **Client ID** - visible under the app name.
* **Secret** - click **Show** to reveal.

Keep these credentials secure. You will need both the Client ID and Secret to configure PayPal in PCI Booking.

## 4. Store in PCI Booking

Create an eWallet account in PCI Booking with:

| Field                   | Description               | Required |
| ----------------------- | ------------------------- | -------- |
| **eWallet Type**        | PayPal                    | Yes      |
| **Merchant Identifier** | Your PayPal Client ID     | Yes      |
| **Secret**              | Your PayPal Client Secret | Yes      |

You can store credentials through the [PCI Booking portal](https://users.pcibooking.net) or programmatically via the [Store Credentials API](/api-reference/payments-library-accounts/store-credentials).

## Testing

PayPal provides a full sandbox environment for testing. To test your integration:

1. In the PayPal Developer Dashboard, switch to **Sandbox** mode and create a sandbox app with its own Client ID and Secret.
2. Create [sandbox test accounts](https://developer.paypal.com/tools/sandbox/) (both buyer and seller) to simulate transactions.
3. Store the sandbox credentials in PCI Booking (use a separate eWallet account for testing).
4. Use the sandbox buyer account to complete a test payment through your checkout page.

Sandbox transactions do not involve real money and do not appear on any live PayPal account.

<Info>
  When you are ready to go live, replace the sandbox credentials with your live Client ID and Secret from the PayPal Developer Dashboard.
</Info>

## Next Steps

<CardGroup cols={2}>
  <Card title="Payments Library Credentials" icon="book" href="/account-setup/payments-library-credentials">
    Overview of all payment method credentials
  </Card>

  <Card title="Payments Library Overview" icon="book" href="/payments-library/overview">
    Integrate the library in your checkout page
  </Card>
</CardGroup>