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

# PayPal

> Connect the PayPal payment gateway to accept PayPal and card payments, let customers save cards on the Billing page, and charge invoices automatically

PayPal payment gateway integration allows you to receive payments with Spacebring.

> [!NOTE]
>
> 🌍 PayPal is available in more than [190 countries](https://www.paypal.com/ua/webapps/mpp/country-worldwide).

> [!NOTE]
>
> PayPal is a distinct company not affiliated with us. For any inquiries regarding PayPal's solutions, services, or pricing, please reach
> out to PayPal directly. We do not have the authority to provide information or support on behalf of PayPal.

## Connect PayPal

To connect PayPal, please follow the steps below.

1. Obtain the [API credentials](https://developer.paypal.com/api/rest/#get-credentials) from your PayPal Dashboard:
   1. Open [PayPal Dashboard](https://developer.paypal.com/dashboard/applications/live) and create a REST API application.
   2. Open the newly created application and copy **Client ID** and `Secret` from the **API CREDENTIALS** section.
2. Go to Spacebring > **Integrations** page by pressing the menu **(...)** next to the location's name.

![Location menu open in the left panel with Integrations highlighted on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/EoXqL0krIeX5lJ8K/images/integrations-connect-a-location-level-integration.png?fit=max\&auto=format\&n=EoXqL0krIeX5lJ8K\&q=85\&s=59910549be2afb079049dadf53f7e2b9)

3. Find the **PayPal** integration page.

![](https://mintcdn.com/spacebring/NXOhFSPltwhOqCNG/images/integrations-payments-paypal-2.png?fit=max\&auto=format\&n=NXOhFSPltwhOqCNG\&q=85\&s=34d64d9865db21585b49abf3f1745ba4)

4. Press **Connect**.
5. Paste your **Client ID** and `Secret`, and press **Connect**.

![PayPal Connect account modal with the client ID and secret on Spacebring's coworking space management
platform](https://mintcdn.com/spacebring/jMBPbg06cdvgMfAB/images/integrations-payments-paypal-3.png?fit=max\&auto=format\&n=jMBPbg06cdvgMfAB\&q=85\&s=0223a9d2c2348922e80ea7ef2a7b7c68)

> [!WARNING]
>
> Your location's currency must be set to one of [PayPal's supported
> currencies](https://developer.paypal.com/docs/reports/reference/paypal-supported-currencies/).

## How PayPal works

The integration adds a new payment method **PayPal** to the **Payment** section in member web portal and mobile app. Users selecting the **PayPal** payment method are redirected to the PayPal payment page and fill in the payment details.

![Accept payments with PayPal on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/NXOhFSPltwhOqCNG/images/integrations-payments-paypal-4.png?fit=max\&auto=format\&n=NXOhFSPltwhOqCNG\&q=85\&s=b1dd6204a2e28ec190fcde14d17576ab)

You can set the payment methods available for your clients in your PayPal account, such as credit and debit cards, PayPal balance, etc. Your members can pay for rooms, desks, events, products, credits, and invoices.

Customers can [save a card](https://www.spacebring.com/docs/billing/payments/payment-gateway.md#add-a-payment-method) on the **Billing** page, so the next payment takes one tap, and set it as the default method for [automatic invoice charges](https://www.spacebring.com/docs/billing/subscriptions/invoice-auto-charge.md). Administrators can also add a card in the customer's profile. A card used on the PayPal payment page is not saved, so a card is saved only when it's added this way.

To check a new card, PayPal places a hold of 1 unit of your location's currency, such as 1 EUR, and cancels it as soon as the card is saved. The customer may briefly see the pending amount in their banking app, but is never charged.

> [!NOTE]
>
> Saving cards needs the **Vault** and **Advanced Credit and Debit Card Payments** features turned on for your REST API application in the
> [PayPal Dashboard](https://developer.paypal.com/dashboard/applications/live). Without them, customers pay with PayPal as before, but can't
> save cards.

## Identify users' transactions in PayPal

You can easily find users' transactions in the PayPal dashboard using the following unique identifiers:

* ID — coincides with **Custom ID** in the PayPal dashboard. You can copy the ID of the transaction from the [transactions report](https://www.spacebring.com/docs/billing/payments/transactions.md#export-a-transactions-report).
* Time — coincides with the date and time of the transaction in the PayPal dashboard.
* Description — the types of purchases users make, such as room bookings, desk bookings, **Shop** orders, etc.

## Disconnect PayPal

To disconnect PayPal integration, follow these steps:

1. Go to Spacebring > **Integrations** page by pressing the menu **(...)** next to the location's name > **PayPal.**
2. Press **Disconnect** and confirm your choice.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.