# Paypal Checkout (Included)

Included with your CommerceLab Shop component is the payment gateway by Paypal let's walk through setup and configuration of this add-on to get you started taking payments.

***

## Getting to Paypal developers site

Youre going to need your paypal credntials for sandbox testing your sites check and live credntials when you're ready to start taking real payments.

* You can get your credentials from the Paypal developers site. Login with your paypal account info or create one.
* <https://developer.paypal.com/developer>

## Creating Paypal sandbox credentials

* When in your Paypal developers area click the left hand menu item "apps & Credentials"

[![](https://app.commercelab.shop/index.php?option=com_ajax\&p=image\&src=WyJpbWFnZXNcL2RvY3VtZW50YXRpb25cL3BheXBhbF9hcHBzLnBuZyIsW1siZG9SZXNpemUiLFszNDUsMTcyLDM0NSwxNzJdXV1d\&hash=b84c79db7755b026e72fe03458628803)](https://app.commercelab.shop/images/documentation/paypal_apps.png)

* With the "SandBox" toggle activated click the button "create app"

[![](https://app.commercelab.shop/index.php?option=com_ajax\&p=image\&src=WyJpbWFnZXNcL2RvY3VtZW50YXRpb25cL2NyZWF0ZWFwcC5wbmciLFtbImRvUmVzaXplIixbNzU1LDQ0MSw3NTUsNDQxXV1dXQ%3D%3D\&hash=4e36c6960388b60e0444e2c6586fb271)](https://app.commercelab.shop/images/documentation/createapp.png)

* Name your new app
* And set your app type to "Merchant"
* Then Create the app
* Copy and save your "Sandbox Client ID" "Sandbox Secret" to use in the following steps you will need to add these to your plugin.

[![](https://app.commercelab.shop/index.php?option=com_ajax\&p=image\&src=WyJpbWFnZXNcL2RvY3VtZW50YXRpb25cL2FwcGNyZWF0ZS5wbmciLFtbImRvUmVzaXplIixbOTEwLDc5NCw5MTAsNzk0XV1dXQ%3D%3D\&hash=473d5171a2e2270826b4fb9563af71df)](https://app.commercelab.shop/images/documentation/appcreate.png)

***

## Creating a live Paypal app keys

* Go back to "Apps & Credentials" tab by clicking the link in the left menu
* Toggle the Switch from "Sandbox" to "live"
* Click the button "Create app"
* Name your new "Live" App and continue
* Copy your "Client ID" & "Secret" keep this safe
* Note: There are no webhooks needed for this Paypal integration.

***

## Paypal Plugin Configuration

* Navigate to your Joomla 4 >> Plugins section and search for "Paypal"
* Click into "Paypal - CommerceLab\Shop"

[![](https://app.commercelab.shop/index.php?option=com_ajax\&p=image\&src=WyJpbWFnZXNcL2RvY3VtZW50YXRpb25cL3NlYXJjaF9wYXlwYWwucG5nIixbWyJkb1Jlc2l6ZSIsWzExNDYsMzA5LDExNDYsMzA5XV1dXQ%3D%3D\&hash=8d64caff381c42b0ff0fda76ad346e70)](https://app.commercelab.shop/images/documentation/search_paypal.png)

* This is where you'll be entering your "Sandbox" credentials
* Leave "User Browser Locale?" Set to yes. This is for advanced usage

[![](https://app.commercelab.shop/index.php?option=com_ajax\&p=image\&src=WyJpbWFnZXNcL2RvY3VtZW50YXRpb25cL3NhbmRlbnRlci5wbmciLFtbImRvUmVzaXplIixbNzI3LDQ3NSw3MjcsNDc1XV1dXQ%3D%3D\&hash=ef5df4ed4be43545f05e9479c0522415)](https://app.commercelab.shop/images/documentation/sandenter.png)

* Toggle the switch to live and enter your live keys
* Leave "User Browser Locale?" Set to yes. This is for advanced usage

[![](https://app.commercelab.shop/index.php?option=com_ajax\&p=image\&src=WyJpbWFnZXNcL2RvY3VtZW50YXRpb25cL2xpdmVfcGF5cGFsLnBuZyIsW1siZG9SZXNpemUiLFs5MzMsNTM2LDkzMyw1MzZdXV1d\&hash=5de847e0f75ce0221bae78c778f84a05)](https://app.commercelab.shop/images/documentation/live_paypal.png)

* Remember to switch the toggle back to "live mode no" so you can test this properly.
* Save and close you're ready to go configure this on your checkout page.

***

## The Paypal standard element

Naviage to your checkout page. In your YOOtheme page builder under "CommerceLab Shop Payment (standard)" elements you can find your Paypal element drag this on to your page. To begin the setup

* Drag this onto to your checkout page and begin configuring tests on your checkout.

[![](https://app.commercelab.shop/templates/yootheme/cache/apypalelement-ae3727d6.png)](https://app.commercelab.shop/images/documentation/apypalelement.png)

## Blank Popup for Paypal Joomla configuration&#x20;

Joomla needs to be configured if you are seeing a blank popup window at paypal checkout.&#x20;

Please change system orgin header to be same-orgin. This will allow popups in System HTTP Headers plugin&#x20;

![](/files/7trgvYBUiX74od91DkuU)![](/files/Q6vy0ClyRh0acFQN4tZk)


---

# 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.commercelab.shop/add-ons/payment-gateways/paypal-checkout-included.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.