Payment Processors

A Payment Processor is how your customers are able to pay you, these services handle the retrieval of the customers money and transfer of it into your account.

Commerce currently supports two of the largest providers PayPal and Stripe.

It is also possible to accept PayPal payments via Braintree.

You will require an account with at least one of these providers before you can accept payments.

The instructions below will guide you through connecting to the different providers.


It is possible to accept payments to PayPal either directly, or via Braintree.

In both cases you will first need to create a PayPal Business account.


If you already have a PayPal Business account you can skip to:

Create PayPal Business Account

Navigate to in new window and enter your email address.

Setup PayPalopen in new window

If you already have a PayPal personal account, you will be able to login to continue your PayPal Business account setup. If not, you will be prompted to enter a password to create a new PayPal account.

Once you have a PayPal Business account, continue to whichever PayPal integration type you would prefer, either Direct or Braintree

PayPal - Direct

Once your PayPal Business account is active you're ready to configure the connection between Commerce and PayPal.

This is a simple process that consists of two main steps.

  1. Grant API Access
    This authorizes Commerce (in a limited capacity) to interact with your PayPal account.

  2. Link PayPal Account
    This lets Commerce know who you are on PayPal so that payments go to the right account.

Grant API Access

  1. Login to your PayPal Business account and access your account settings by navigating to in new window or by clicking on the gear icon in the header.

    Grant PayPal API Access 1

  2. In the left sidebar, click on "Selling Tools".

    Grant PayPal API Access 2

  3. Next to "API Access", click on "Update".

    Grant PayPal API Access 3

  4. Under "Pre-built payment solution", click on "Grant API Permission".

    Grant PayPal API Access 4

  5. For the "Third Party Permission Username", type in and then click "Lookup".

    Grant PayPal API Access 5

  6. Under "Available Permissions", tick the following five checkboxes and then click "Add".

    ✓ User Express Checkout to process payments.
    ✓ Issue a refund for a specific transaction.
    ✓ Process your customers credit or debit card payments.
    ✓ Obtain information about a single transaction.
    ✓ Use Express Checkout to process mobile payments.

    Grant PayPal API Access 6

  7. You should be presented with a green success message that states "You have successfully added"

    Grant PayPal API Access 7

Now that you have granted API access via the instructions above, you can link Commerce to PayPal simply by letting us know the email address of your Business account.

  1. Access the Commerce administration areaopen in new window and navigate to the Settings/Paymentsopen in new window screen.

  2. Enter your PayPal Business account email address into the PayPal field and press 'Save Email'.


🎉 You have now completed the connection between PayPal and Commerce.

PayPal - Braintree

Braintree is a PayPal company and can act as an alternative provider for accepting PayPal payments.

To accept PayPal payments via Braintree you will first need to have a PayPal Business account and you will also need to have a Braintree account.


If you have already set up PayPal - Direct you do not need to configure this integration.

Create Braintree Account

  1. Navigate to https://apply.braintreegateway.comopen in new window and fill out the application form.

    Create Braintree Account 1

  2. Braintree accounts will normally be available shortly after the application has been submitted, however in some cases it can take several days for Braintree to follow up to complete the application process.

  3. Once you have a Braintree account, continue to the next step - Link PayPal Business with Braintree

  1. Once your Braintree account is active, login to your control panel at in new window

  2. Navigate to Settings > Processing > PayPal

    Create Braintree Account 1

  3. Click the PayPal toggle and you should be presented with the Accept PayPal page

    Create Braintree Account 1

  4. Click the Log In with PayPal button

  5. Enter your PayPal credentials and then click Log In

  6. Enter the URL for your website's Privacy Policy in the applicable fields

  7. Click submit


Add documentation


🎉 You have now completed the connection between PayPal and Commerce via Braintree.


To accept card payments via Stripe you will require a Stripe Account.


Add documentation


🎉 You have now completed the connection between Stripe and Commerce.