Introduction

PayPal Plus is an add-on product for accounts based in Germany, Mexico, and Brazil that provides PayPal payments and direct credit card payments on your website.

This guide will show you how to create a PayPal app for use with the plugin, and then configure the plugin to enable PayPal Plus on your WooCommerce website.

If you need help installing the plugin, take a look at our install guide before moving forward here.

NOTE

It is recommended that you create a PayPal sandbox seller account prior to completing this guide if you do not already have at least one created in your PayPal developer account.

Video Overview

Setup Steps

1. Login to your PayPal developer account dashboard.

  • Login to https://developer.paypal.com using your live PayPal account credentials.
  • Then click Dashboard to enter your PayPal developer dashboard.

WooCommerce PayPal Plus PayPal Developer Login

WooCommerce PayPal Plus PayPal Developer Login

 

2. Click My Apps & Credentials

  • On the left side of the dashboard screen, click My Apps & Credentials.

WooCommerce PayPal Plus REST App Credentials

WooCommerce PayPal Plus REST App Credentials

 

3. Create a REST Application

  • Scroll down to the REST Apps section of the page.
  • Click the Create App button.
  • Enter a name for the new app, and choose a sandbox account to associate with it.
    • Your live account is already associated with this app by way of logging in to the PayPal developer dashboard.
  • Click the Create App button again to officially create the new app.
  • NOTE:  If you have already created a rest app you can click into your app to view / edit details.

WooCommerce PayPal Plus REST Create App

WooCommerce PayPal Plus REST Create App

WooCommerce PayPal Plus REST Create App

WooCommerce PayPal Plus REST Create App

4. Configure application settings and save.

  • Select Sandbox or Live depending on which version of your app you would like to update.
    • The sandbox is used for testing purposes.

PayPal REST API App Sandbox Live

PayPal REST API App Sandbox / Live Setting

  • Under the API Credentials section you will see your Client ID.
    • This will be copied / pasted into the plugin settings in WordPress later, so you may want to make record of it now.

PayPal REST App Client ID

PayPal REST App Client ID

  • Click the Show link under Secret to display the Client Secret credentials section.
  • If you do not already have a Secret displayed here, click the Generate New Secret button.
    • This will be copied / pasted into the plugin settings in WordPress later, so you may want to make record of it now.

PayPal REST API Secret ID

PayPal REST API Secret ID

  • Review and adjust the remaining application settings to suit your needs.
  • Click Save to finalize the creation of the app.

PayPal REST API App Settings

PayPal REST API App Settings

5. From the WordPress dashboard, navigate to WooCommerce -> Settings

"WordPress

6. Click on the Checkout tab, and then click PayPal Plus.

WooCommerce PayPal Plus Checkout Settings

WooCommerce PayPal Plus Checkout Settings

7. Configure the PayPal Plus settings

  • Make the necessary adjustments to the WooCommerce PayPal Plus settings.
  • Click Save to save your changes.
Enable / Disable

Check this box to enable the payment gateway. Leave unchecked to disable it.

Title

This controls the label the user will see for this payment option during checkout.

Description

This controls the description the user will see for this payment option during checkout.

PayPal Account Country

Set this to the country that your PayPal Plus account is based in.

  • This is important because the checkout experience for different countries varies slightly.
PayPal Sandbox

Check this box to enable test mode so that all transactions will hit PayPal’s sandbox server instead of the live server. This should only be used during development as no real transactions will occur when this is enabled.

Client ID and Secret ID
  • Copy and paste your Client ID and Secret ID from your PayPal developer application created above.
  • NOTE:  These fields will change to “sandbox” fields vs. “live” fields depending on whether or not PayPal Sandbox is enabled or not.  Make sure you are filling in the values into the correct fields!
Invoice ID Prefix

This allows you to set a value to be used as the prefix on invoice IDs generated by WooCommerce.

This can help to resolve duplicate invoice issues that may arise if you’re using PayPal on multiple websites where the same invoice IDs can get used. A prefix is required to avoid declined payments when this happens.

Cancel URL

This is the URL PayPal will send users to if they cancel / close the PayPal Plus checkout experience prior to completing their payment.

Brand Name

This controls what users will see for the brand / company name on PayPal review pages.

PayPal Express Checkout Brand Name

PayPal Plus Checkout Brand Name

PayPal Checkout Logo (190x60)

Here you may add the URL of an image you would like to display as the logo on the PayPal Plus Checkout pages.

  • If you have “Force Secure Checkout” enabled in WooCommerce, which means you must have a valid SSL certificate installed on your site, then you will be able to simply upload an image using the WordPress media manager.
  • If you do not have an SSL certificate for your site you may upload your image to any SSL image service and simply copy/paste the URL here. We recommend SSLpic for this service.
Auto Cancel / Refund Orders

PayPal Seller Protection can be an important feature to help protect you from fraud.  You may use this setting to automatically cancel and refund an order if it is not covered by PayPal Seller Protection.

  • Do not cancel any orders.
    • This is the default setting and will not automatically cancel / refund any order.
  • Do *not* have PayPal Seller Protection
    • This will automatically cancel and refund any order that is not covered by PayPal Seller Protection.
  • Do *not* have PayPal Unauthorized Payment Protection
    • This will automatically cancel and refund any order that is not covered with unauthorized payment protection.
Legal Note for Pay Upon Invoice Payments

PayPal Plus provides a “Pay Upon Invoice” option which allows a person to complete checkout, and then submit payment later.

This note will be displayed to buyers on the order receipt / thank you page as well as in email notifications.

Ratenzahlung

If you have Ratenzahlung enabled on your PayPal Plus account you will need to enable it here so that it will be included in the PayPal Plus iFrame during checkout.

NOTE:  PayPal Ratenzahlung for WooCommerce is available as a separate plugin.

Debug Log

Check this box to enable logging for PayPal Plus Checkout API calls. These logs will be saved under /wp-content/uploads/wc-logs/.

Need Help?

If you are struggling to get things working after reviewing this setup guide, please create a support ticket and we can help you directly.