Web Design Spanish version

Support article

How to Configure PayPal in WooCommerce Step by Step

Set up PayPal in your WooCommerce store: create a business account, API keys, sandbox mode, testing and activation to charge for real.

Published: 11/07/2026 Updated: 11/07/2026

Introduction

PayPal is one of the best-known payment methods in the world. Many customers prefer it because they don’t need to enter their card details in every store: they pay with their email and PayPal password.

In this article you’ll see how to install and configure PayPal in your WooCommerce store, from creating the business account to your first test sale.

Why offer PayPal in your store

Adding PayPal as a payment method has several advantages:

  • It builds trust. The customer recognizes the brand and feels safer.
  • It’s fast. The customer pays without typing their card details.
  • It’s widely used. It works in over 200 countries.
  • It includes buyer protection, which can increase your conversion rate.

What you need before you start

Before configuring PayPal, make sure you have:

  1. A working WooCommerce store.
  2. An active SSL certificate. PayPal requires your site to load with https://.
  3. A PayPal Business account. A personal account isn’t suitable for charging in an online store.

[Imagen sugerida: screenshot of the PayPal Business sign-up page]

The SSL certificate is mandatory for any payment gateway. At miHosting all plans include free SSL with Let’s Encrypt.

Step 1: Create a PayPal Business account

  1. Go to the PayPal website and select Open a Business account.
  2. Fill in your business details: name, address, email and phone.
  3. Indicate your business category and briefly describe what you sell.
  4. Link your bank account or card to receive payments.
  5. PayPal will ask you to verify your identity with a document.

Once verified, you can access the PayPal dashboard where the keys are configured.

Step 2: Get your API credentials

PayPal uses credentials to connect to your store. You need them in both test and production mode.

  1. Log in to the PayPal Business dashboard.
  2. Find the Tools → All tools or Apps & Credentials section.
  3. Go to My REST apps.
  4. Create a new application, for example named “My WooCommerce store”.
  5. PayPal will show you two sets of credentials:
    • Sandbox credentials (for testing).
    • Production credentials (for real sales).

[Imagen sugerida: screenshot of API credentials in the PayPal dashboard]

Each environment includes:

  • Client ID (public identifier).
  • Secret (secret key, don’t share it).

Step 3: Install the PayPal plugin in WooCommerce

  1. Log in to the WordPress admin panel (yourdomain.com/wp-admin).
  2. Go to Plugins → Add New.
  3. Search for WooCommerce PayPal Payments (official plugin).
  4. Click Install Now and then Activate.

Always use the official PayPal plugin for WooCommerce. Avoid unverified third-party plugins, as they may not be secure.

Step 4: Configure the PayPal plugin

  1. Go to WooCommerce → Settings → Payments.
  2. Find PayPal in the payment methods list.
  3. Click Set up or Manage.
  4. Check the Enable PayPal option.
  5. Paste your Sandbox credentials:
    • Sandbox Client ID.
    • Sandbox Secret.
  6. Enable Sandbox mode while testing.

[Imagen sugerida: screenshot of the PayPal plugin configuration screen in WooCommerce]

  • PayPal button on cart and checkout: recommended, improves conversion.
  • Card payment via PayPal: optional, lets you charge by card without the customer leaving your site.
  • Error log: useful in testing, disable it in production.
  1. Click Save changes.

Step 5: Test a purchase in Sandbox mode

Before activating PayPal in production, run a test purchase:

  1. Make sure Sandbox mode is active.
  2. PayPal automatically creates two test accounts:
    • Merchant account (for you).
    • Buyer account (to simulate a customer).
  3. Enter your store as a customer.
  4. Add a product to the cart and select PayPal at checkout.
  5. Sign in to the Sandbox environment with the test buyer account.
  6. Confirm the payment.
  7. Verify that:
    • The order appears under WooCommerce → Orders.
    • The payment appears as “completed” in the Sandbox merchant account.

[Imagen sugerida: screenshot of the PayPal Sandbox test environment]

Step 6: Activate PayPal in production

When the test works, move to production:

  1. Go back to WooCommerce → Settings → Payments → PayPal.
  2. Replace the Sandbox credentials with production credentials.
  3. Disable Sandbox mode.
  4. Save the changes.
  5. Run a real purchase with a minimal amount to confirm everything works.

PayPal transfers funds to your linked bank account. The transfer time depends on your country, but is usually 1 to 3 business days.

Useful tips

  • Offer PayPal alongside another gateway. PayPal and Stripe are complementary: some customers prefer card and others prefer PayPal.
  • Customize the payment page. In the PayPal dashboard you can add your logo so the customer sees your brand during payment.
  • Keep the plugin updated. Official plugin updates fix bugs and add compatibility with new WooCommerce versions.
  • Back up before updating. An update can affect the gateway configuration.
  • Review refunds. You can refund from WooCommerce or from the PayPal dashboard. Always use the same channel to avoid inconsistencies.

Common problems

PayPal doesn’t appear at checkout

Check that the plugin is active and that the method is marked as active under WooCommerce → Settings → Payments.

The customer sees a redirect error

The most common cause is SSL not being configured correctly or mixed content. Verify that your entire site loads with https://.

The payment shows as “pending” in WooCommerce

The payment may not have fully completed, or there may be a communication delay between PayPal and WooCommerce. Check the status in the PayPal dashboard and the IPN/webhook log.

Credentials give an error

Make sure you use the correct Client ID and Secret for each environment. Don’t mix Sandbox credentials with production ones.

The customer pays but the order isn’t registered

This can happen if PayPal’s notification (IPN or webhook) doesn’t reach your store. Verify that your hosting isn’t blocking incoming PayPal connections.

Frequently asked questions

Does PayPal charge a fee?

Yes. PayPal charges a commission on each transaction. The percentage varies by country and type of sale. Check updated rates on the PayPal website.

Do I need a business account or is personal enough?

You need a PayPal Business account. The personal account isn’t designed for charging in an online store.

Can I charge by card without the customer leaving my site?

Yes. PayPal offers advanced card payment that lets you charge without redirecting the customer. It may have an additional cost depending on your country.

How long does PayPal take to settle payments?

PayPal balance transfers to your bank account in 1 to 3 business days, depending on the country.

Can I issue refunds from WooCommerce?

Yes. If you refund from WooCommerce, the official plugin processes the refund automatically in the customer’s PayPal account.

Start accepting PayPal in your store

Configuring PayPal in WooCommerce is a simple process if you do it in order: create the business account, get the credentials, install the official plugin, test in Sandbox, and when everything works, activate production.

If you need help with SSL, PHP version, or any hosting setting, open a support ticket from your client panel. And if you don’t yet have hosting for your WooCommerce store, at miHosting you have optimized plans with free SSL, LiteSpeed cache and support from real technicians.