Screen: ShopSite > Commerce Setup > Payment > Configure Processor

PayPal Payments Pro Settings

Overview

If you have a PayPal Business account, you can configure your ShopSite store to let customers pay to your PayPal account via credit card or PayPal. With PayPal, you can accept credit card payments without having to have a merchant account, and your customers can also pay by check and bank transfer. It doesn’t matter to you how they choose to pay — the payments are simply deposited into your PayPal account.

PayPal Payments Pro uses PayPal's Direct Payment API, which allows you to accept PayPal and credit card payments to your PayPal account. The Direct Payment API behaves like a payment gateway, and you will be charged monthly and per-transaction fees for using it.

To use the Direct Payment API, you must complete all the steps, including steps 2 and 3, below, and you must select PayPal Payments Pro as your Credit Card Processor on the Payment configuration screen.

If you don’t have a PayPal account, click here to fill out the simple application. To apply for a Business Account, click the Business link at the top of the Sign Up form. If you already have a PayPal Personal account, upgrade it to a Business account on the PayPal Web site.

Note:
Because the process of setting up a PayPal account to use PayPal Payments Pro is controlled by PayPal, the process could change without warning. These instructions are based off the way it worked when this document was written.

  1. Set Up a PayPal account
    If you don't already have a PayPal account, you will need to create one here.

    If you have a standard PayPal account, you will need to upgrade to a Business account. You can upgrade by clicking on the Upgrade Account link after logging in to the PayPal website.

  2. Apply for Payments Pro
    To use the Direct Payment API, you must apply to use Payments Pro. You may see a link to do this from your main PayPal account screen. If not, go to Merchant Tools and click on Payments Pro. Click on the Submit Application link, which you will find partway down the screen at the end of the right-hand column.

    Follow the application instructions. You must fill out every field not marked as (Optional), and agree to all the terms and agreements.

  3. Accept Billing Agreement
    After you have completed the Payments Pro application, you will need to accept the billing agreement. To do this, return to the Overview screen under the My Account tab, and click on the link to Accept Billing Agreement.

  4. Create A Certificate
    From the My Account tab, go to the Profile screen, and click on the API Access link, where you should find an Request API Credentials link. Click on that, then select an API SSL client-side certificate, agree to the Terms Of Use, and click Continue.

  5. Download the Certificate
    Once the certificate has been generated, you will be prompted to download it. Save the certificate in a location you will remember. You will be prompted to copy the certificate contents into ShopSite's PayPal configuration screen later, along with the API Username you were assigned. If you don't remember your API Username, or forget where you stored the certificate, you can go back to the API Access screen and view your username and download the certificate again.

Your PayPal account is now configured to use Payments Pro. The information below will help you set up ShopSite to use your PayPal settings.

Setup

On the Commerce Setup screen, select Payment, then select PayPal Payments Pro from the Credit Cards drop-down box and click the associated Configure button. When you click the Configure button for PayPal Payments Pro, you will see a screen with the following fields:

Host
Host
Select whether you want to use the PayPal sandbox server (for testing) or the Live payment server.
Note:
The PayPal sandbox server can not be used in conjunction with a standard PayPal account. You must create a sandbox account if you wish to use the sandbox server. Sandbox accounts can be created by members of the PayPal Developer Network.

Authentication
Authorization Method *
Use the radio buttons to pick which authorization method to use.

Use API Certificate Authentication
This authentication method uses a digital certificate, generated by PayPal for API Access for Payments Pro. This method is more secure than the digital signature, but has a greater risk of user error.

API Username
Enter the API username that you were given when you generated your API Access Certificate for Payments Pro.
API Password
Enter the password that you set up when you signed up for Payments Pro.
API Certificate
Copy the digital certificate you received from PayPal into this box. Be sure to include the entire certificate, including the RSA Key.
Use API Digital Signature Authentication
This authentication method is PayPal's preferred method of authentication. Similar to the API Certificate Authentication, this method uses a digital signature, generated by PayPal for API Access for Payments Pro.

API Username
Enter the API username that you were given when you generated your API Access Certificate for Payments Pro.
API Password
Enter the password that you set up when you signed up for Payments Pro.
API Digital Signature
Copy the digital signature you received from PayPal into this box.
3rd-Party Account
If you have authorized a 3rd-party account to access your PayPal information, you can put that account API ID here. Most merchants will want to leave this blank.
Order Payment Action
Select whether to use Sale (authorize and capture) or Authorize (authorize only) mode when processing payments. If you must prepare products for shipping, you should use authorize only mode, then when your products are ready to ship, you can capture the funds from the Orders screen.

Error Reporting Settings
Display Error Details
Check this box to have detailed error messages appear when a PayPal error occurs during the order processing.

Credit Cards
Supported cards and other payment types
Check the boxes for the credit cards you want to accept through PayPal. Choices include: Visa, MasterCard, Discover, American Express, and Diner's Club/Carte Blanche.
CVV2 Help Text
This is the text for the link to a defintion of CVV2 that the shopper can click on during checkout.
CVV2 Help URL
This is the URL to the help link in the previous field.

Credit Cards
Supported cards and other payment types Select which credit cards you want to accept payments from. If you are using a real-time payment gateway, you should check to see what cards your gateway accepts, and what the fees for those cards are. Check the box beside the card name to accept payment from that card. You can select any (or all) of the following:
  • Visa
  • MasterCard
  • Discover
  • American Express
  • Diner's Club/Carte Blanche
CVV2 Help Text Enter the text to be used for the CVV2 Help Link. If your credit card processor is configured to include a CVV2 field with the payment information, this text will be displayed as a link beside the field.
CVV2 Help URL This is the URL to be used for the CVV2 Help Link. When a customer clicks the link beside the CVV2 field, a new window will open to this URL. You can use the default URL or you can create your own page explaining what a CVV2 is and where to find it on a credit card.

Fill in the proper values, click the Save and Enable button, and you're all set.

ShopSite Help and Resource Center
Last updated: December 30, 2013
Give Feedback

ShopSite Shopping Cart Software