---
title: Configuring PayPal
related:
  - https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/configuring-payment-methods.md
  - https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/checkout-process.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

[PayPal](https://www.paypal.com/) is one of the most popular on-line payment systems. It allows you to perform money transfers between bank accounts, which are identified by e-mail addresses. Each account is linked to one or more credit cards, e.g. a VISA card, with on-line payment enabled.

While using the Kentico PayPal payment gateway, your on-line store customers can make payment in the following [currencies](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/configuring-currencies.md):

- **United States Dollar** (USD)
- **Euro** (EUR)
- **Pound Sterling** (GBP)
- **Canadian Dollar** (CAD)
- **Australian Dollar** (AUD)
- **Japanese Yen** (JPY)

> **Info:** If your system uses more then two decimal places, the price is always rounded to two decimal places. Otherwise, the PayPal payment gateway does not allow the payment.

## Requirements

To use PayPal in Kentico, you need a **PayPal account**. See [PayPal](https://www.paypal.com/signup/account) website for more details.

## PayPal payment process scheme

![Interaction between your website and PayPal](https://docs.kentico.com/docsassets/k9/configuring-paypal/how_it_works.png "Interaction between your website and PayPal")

## Configuring PayPal in Kentico

Before your [customers](https://docs.kentico.com/k9/e-commerce-features/managing-your-store/customers.md) can start using the PayPal payment gateway, you need to perform the following configuration:

1. Open the **Settings** application.
2. Navigate to the **E-commerce -> Payment Gateways -> PayPal** setting category in the settings tree.
3. Specify the **Business** setting to identify your payments.

   - **Business** – the e-mail address of the merchant's PayPal account.
4. (Optional) Specify other PayPal gateway settings.

   - **Cancel return URL** – the URL to which the buyer’s browser is redirected if the payment is cancelled; e.g. a URL on your website that displays your custom _Payment canceled_ page. By default, the browser is redirected to a PayPal page.
   - **Notify URL** – the URL to which PayPal posts information about the transaction; see [PayPal IPN](#ipn-instant-payment-notification) for more details. If specified, overrides the settings in the PayPal merchant's interface.
   - **Return URL** – the URL to which the buyer’s browser is redirected if the payment is successfully completed; e.g. a URL on your website that displays your custom _Thank you for your payment_ page. By default, the browser is redirected to a PayPal page.

     > **Info:** The _Return URL_ value, that you send to PayPal, is visible in query strings and is therefore easily manipulated. To prevent this issue, we recommend to use [PayPal IPN](#ipn-instant-payment-notification).
5. In **Store configuration -> Payment** methods,ensure that the PayPal payment method is [registered and enabled](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/configuring-payment-methods.md) and it has the following properties filled:
   - **Payment gateway URL**: _https://www.paypal.com/cgi-bin/webscr_
   - **Payment gateway provider class**:
     - _Assembly name_: CMS.EcommerceProvider
     - _Class_: CMS.EcommerceProvider.CMSPayPalProvider

> **Tip:** If you want your transactions to be processed as test transactions, use _https://www.sandbox.paypal.com/cgi-bin/webscr_ as your payment gateway URL and sign up for the _PayPal SandBox_ testing environment. See the [PayPal](https://cms.paypal.com/us/cgi-bin/?cmd=_render-content\&content_ID=developer/howto_testing_sandbox) website for more details.

The system now provides also payment with PayPal.

## IPN – Instant Payment Notification

[Instant Payment Notification (IPN)](https://www.paypal.com/ipn) is a message service that notifies you about events related to payments processed through PayPal. It is a web-based callback mechanism that calls a pre-configured URL on your site. For the service to be functional, IPN must be enabled on the PayPal side.

After processing an order, PayPal sends a confirmation to your pre-configured URL. PayPal then expects a reply from you within a short period of time (a few minutes), and returns a response to confirm that the customer paid.

IPN is optional, but it is a requirement if you need to immediately confirm payments for orders to your customers.

## Configuring PayPal in the checkout process

If your customers use the PayPal payment method, they do not need to fill any additional information in the appropriate step (usually the **Payment** step) of the [checkout process](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/checkout-process.md). After clicking the corresponding button, the system redirects them to the PayPal payment gateway to finish payment.

You need to place the **Payment form** web part on the payment page when [configuring the checkout process](https://docs.kentico.com/display/K9/Checkout+process).

![Using PayPal - checkout process](https://docs.kentico.com/docsassets/k9/configuring-paypal/paying_paypal.png "Using PayPal - checkout process")