Is this really the version you are looking for? Kentico Xperience 11 Documentation is no longer updated. Use the switcher in the header to choose your product version.
PayPal (opens in a new tab) is one of the most popular on-line payment systems. It allows you to perform money transfers between bank accounts, which are identified by email 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 payments in the following currencies:
If your currencies are configured to use more than two decimal places, the price is always rounded to two decimal places. Otherwise, the PayPal payment gateway would not allow the payment.
To accept PayPal payments on a Kentico website, you need:
Before your customers can start using the PayPal payment gateway, you need to perform the following configuration:
Find the API credentials (Client ID and Secret) of your REST API app in the PayPal Developer Portal (opens in a new tab).
Open the Settings application in Kentico.
Navigate to the E-commerce -> Payment Gateways -> PayPal category in the settings tree.
Copy the API credentials into the Client ID and Client secret settings.
Select the Account type associated with the credentials – Sandbox accounts are for test transactions, Live accounts are for real payments on production websites.
For more information about testing of PayPal transactions, see the Sandbox overview (opens in a new tab) in the PayPal documentation.
Specify the return URL values for your website's pages:
Select the Transaction type that you wish to use for payments:
Direct Payment – successful transactions are marked for immediate funds transfer (capture) when orders are placed.
Authorization with Delayed Capture – only authorization occurs during the initial payment (places a hold on the cardholder's available fund limit). The store's administrators need to capture funds manually at a later time by editing orders.
Delayed capture transactions are suitable for stores where products are physically shipped some time after orders are placed.
Note that authorized transactions only remain valid for a limited number of days (depending on the gateway's current policy). If the funds are not captured before the authorization expires, the gateway releases the held amount and the payment cannot be completed.
Open the Store configuration application and select the Payment methods tab.
Ensure that a payment method is registered and enabled for PayPal, with the correct provider class assigned:
Additionally, you need to adjust the content of certain pages that are part of your website's checkout process:
The system now provides payment via PayPal. Customers who select the PayPal payment method do not need to fill in any additional information during the payment step of the checkout process. After clicking the payment button, the system redirects them to the appropriate PayPal confirmation page to finish the payment.
The default Kentico PayPal provider does not utilize payment notifications – Webhooks or Instant Payment Notification (IPN).
If you require payment notifications for any custom functionality or integrations, you need to configure the related options for your PayPal Business account and implement the required handlers (either within the Kentico web project or a custom project).
For more information, see the Notifications (opens in a new tab) section of the PayPal documentation.