Setting up Paypal Express Checkout
page last edited on 15 February 2017
This article explains how to set up Paypal Express Checkout in X-Cart.
Table of Contents
- Table of Contents
- Setting up Express Checkout with email
- Enabling the Secure Token setting
- Creating your custom PayPal payment page
Setting up Express Checkout with email
For a quick start, Paypal Express Checkout requires you to specify your email only:
- If you already have a Paypal account, then you should specify the email you created your Paypal account with.
- If you do not yet have a Paypal account, then you can specify the email you are going to create your Paypal account with and create the account itself later on.
Setting up Express Checkout with API credentials
For a full-fledged Express Checkout implementation allowing payments and post-checkout operations, you will need to use the API option:
After choosing this option, you will need to specify a set of credentials for access to the API. Two API options are supported: PayPal API and Payflow API. PayPal API (Merchant API) will work for most merchants. If you can, use PayPal API. If you only have access to Payflow API, then use Payflow API.
Your choice of an API solution will determine the type of API credentials that you will need to enter.
For PayPal API, you will need the following set of credentials:
- Partner name (should always be “PayPal”),
- API access username,
- API access password,
- API signature or API certificate (The Use PayPal authentication method box allows you to choose, which one you want to use).
The above named credentials can be retrieved in your PayPal account profile.
For Payflow API, you will need the following set of credentials:
- Partner name,
- Merchant login,
These are the same credentials that are used as your manager.paypal.com login information.
Enabling the Secure Token setting
You may need to include this option if you want to capture payments authorized by Paypal via the admin interface of your X-Cart store. Using this option requires you to have a Paypal Advanced Payments or a Paypal Payflow Pro account.
How to enable the Secure Token setting:
- Log in to your PayPal Manager account;
Click Service Settings;
Under Hosted Checkout Pages, click Set Up;
Set Enable Secure Token to Yes;
Click Save Changes;
- Fill in the API credentials into the PayPal Express Checkout settings form in X-Cart.
Creating your custom PayPal payment page
Creating a custom payment page allows you to co-brand the PayPal checkout pages with your logo and colors.
Log in to your PayPal account.
Underneath the My Account tab, click Profile;
Click My selling tools;
Locate Custom payment pages, and click the Update link next to it;
In the Page Style Name box, give a name to your custom page style. (It doesn’t matter what you put here, as long as it isn’t “PayPal”.);
In the Logo Image URL box, enter the URL of your logo image. Your logo image should be 190x60px, and should be hosted on an SSL-secured (https://) site. If you do not have an SSL-secured site available to you, free alternatives (such as sslpic.com) are available.
In the Cart Area Gradient Color box, enter an HTML hex code that represents the gradient color you want to use around the shopping cart section of the checkout page.
Click the radio button next to the new payment page style you just created, and click Make Primary. Your custom payment page style will now be used whenever buyers choose to pay with PayPal.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.