How to Configure PayPal in Magento

PayPal is a widely used online payment solution that allows customers to pay for products using their PayPal account and, depending on the configured PayPal service and customer eligibility, other supported payment options.

Magento and Adobe Commerce provide PayPal integrations that can be configured from the Admin Panel. Current Magento installations may use PayPal Express Checkout or Payment Services, depending on the edition, version, and installed modules. (Experience League)

In this guide, you will learn how to configure PayPal in Magento, connect the payment service, test transactions, and troubleshoot common configuration problems.

Why Use PayPal in Magento?

Adding PayPal to your Magento store can provide customers with another convenient way to pay.

Benefits include:

• Familiar checkout experience.
• Support for PayPal account payments.
• Express checkout capabilities.
• Sandbox testing before going live.
• Payment authorization and capture options.
• Support for additional PayPal payment experiences depending on the integration.
• Reduced need to build a payment system from scratch.

The features available depend on the PayPal integration and your country, account, Magento version, and configuration.

Before Configuring PayPal

Before beginning, prepare the following:

1. A working Magento store.
2. Magento Admin access.
3. A PayPal account suitable for receiving business payments.
4. HTTPS enabled on your store.
5. A supported Magento PayPal integration.
6. Sandbox credentials if you want to test before going live.

Adobe’s current documentation recommends using sandbox credentials for testing and production credentials for a live store. (Experience League)

Step 1: Log in to Magento Admin

Log in to your Magento Admin Panel using an administrator account.

After logging in, you will see the Magento dashboard.

Step 2: Open Payment Configuration

From the Magento Admin Panel, go to:

Stores → Configuration

Then select:

Sales → Payment Methods

The Payment Methods page contains the payment options available in your Magento installation. (Experience League)

If your store has multiple websites, select the appropriate configuration scope before changing PayPal settings.

Step 3: Locate PayPal

Depending on your Magento version and installed modules, you may see PayPal under sections such as:

• PayPal Express Checkout
• Payment Services
• Other PayPal-related payment integrations

Current Adobe Commerce documentation lists PayPal Express Checkout and Payment Services among the supported/recommended PayPal-related solutions, while some older PayPal integrations may have different availability depending on the Magento release. (Experience League)

Step 4: Configure PayPal Express Checkout

If your installation uses PayPal Express Checkout, open:

PayPal Express Checkout → Configure

Magento provides several configuration sections for the integration. (Experience League)

The exact fields may vary according to your Magento version.

Step 5: Connect Your PayPal Account

For supported Adobe Commerce configurations, you can connect the PayPal account through the Admin Panel.

You may have options to connect:

• A live PayPal account.
• A PayPal Sandbox account for testing.

For a production store, connect the live account only after completing testing.

Adobe recommends using sandbox credentials in testing environments and switching to production credentials when the store is ready to accept real payments. (Experience League)

Step 6: Configure PayPal API Credentials

If your PayPal integration requires manual API credentials, enter the credentials supplied by PayPal.

Depending on the integration, these can include:

• API Username
• API Password
• API Signature
• API Certificate

PayPal Express Checkout supports API Signature and API Certificate authentication methods in its configuration. (Experience League)

Important

Never publish PayPal API credentials in website content, source code, screenshots, or public repositories.

Step 7: Enable PayPal

Find the setting:

Enable this Solution

Set it to:

Yes

This activates PayPal as a payment method for customers, assuming the other configuration requirements are satisfied. (Experience League)

Save the configuration after making the change.

Step 8: Configure Sandbox Mode

If you are testing PayPal, enable the appropriate sandbox configuration.

For PayPal Express Checkout, Magento provides a Sandbox Mode setting. When using sandbox credentials, set the mode appropriately so transactions are directed to the testing environment rather than the live PayPal service. (Experience League)

A typical testing workflow is:

Magento Store
      ↓
PayPal Sandbox
      ↓
Test Customer
      ↓
Test Payment
      ↓
Magento Order

Do not use real customer payments while testing with sandbox credentials.

Step 9: Configure the Payment Action

PayPal Express Checkout provides payment-action options such as:

• Authorization
• Sale
• Order

Authorization approves the payment but leaves the funds available for later capture.

Sale authorizes and captures the payment as part of the transaction.

Order can be used for workflows where funds are captured later through invoices, subject to PayPal’s applicable rules. (Experience League)

Choose the payment action that matches your order-processing workflow.

Step 10: Configure the Checkout Display

You can configure how PayPal appears to customers.

Depending on the integration, options can include:

• PayPal checkout button.
• Display on product pages.
• Display in the shopping cart.
• PayPal payment option during checkout.
• PayPal Credit or other supported PayPal experiences.

For example, PayPal Express Checkout provides settings for displaying a PayPal checkout button on product pages and the shopping cart. (Experience League)

Step 11: Configure the Payment Title

The Title determines how the PayPal payment method is identified during checkout.

For example:

Pay with PayPal

or:

PayPal

Use a short and recognizable title so customers understand the payment option.

Step 12: Set the Sort Order

The Sort Order determines where PayPal appears relative to other payment methods.

For example:

1. PayPal
2. Credit/Debit Card
3. Cash on Delivery
4. Bank Transfer

The actual order depends on your store’s enabled payment methods.

Step 13: Configure Applicable Countries

Magento allows payment methods to be restricted to particular countries.

Depending on the PayPal integration, you may be able to choose:

All Allowed Countries

or:

Specific Countries

If you select specific countries, only customers meeting the configured country requirements will be able to use the payment method. (Experience League)

Make sure your selected countries are supported by your PayPal account and payment service.

Step 14: Configure PayPal Payment Services

If your Magento installation uses Payment Services, the configuration is different from legacy PayPal Express Checkout.

Go to:

Sales → Payment Services

and open the settings.

Payment Services provides a centralized configuration for PayPal-related payment buttons and other supported payment methods. (Experience League)

Depending on your setup, you can configure:

• Payment mode.
• Sandbox or production environment.
• PayPal buttons.
• Payment action.
• PayPal Pay Later.
• Credit/debit card button.
• Button placement.
• Button styling.

Step 15: Choose Sandbox or Production Mode

Payment Services provides a payment mode that can be configured for:

• Sandbox
• Production

Use Sandbox while testing.

Once the complete payment workflow has been successfully tested, configure the production environment for live transactions. (Experience League)

Step 16: Configure PayPal Buttons

Payment Services can provide PayPal buttons in different areas of the storefront.

Depending on your configuration, you may be able to enable PayPal buttons on:

• Checkout page
• Product detail page
• Mini-cart
• Cart page

It can also provide additional options such as Pay Later messaging and other supported payment buttons. (Experience League)

Only enable the options that make sense for your store’s checkout experience.

Step 17: Save the Configuration

After configuring PayPal, click:

Save Config

Magento may require configuration or cache refreshes before changes become visible on the storefront.

If PayPal does not appear immediately, verify the configuration and refresh the appropriate Magento caches.

Step 18: Test PayPal

Testing should be performed before enabling live payments.

For sandbox testing:

1. Enable sandbox mode.
2. Connect the sandbox PayPal account.
3. Open your storefront.
4. Add a product to the cart.
5. Proceed to checkout.
6. Select PayPal.
7. Complete a test transaction.
8. Return to Magento Admin.
9. Check the order.
10. Verify the payment status and transaction information.

Also test unsuccessful transactions where possible.

Step 19: Switch to Live PayPal

After successful sandbox testing:

1. Disable sandbox mode.
2. Configure the production PayPal account.
3. Enter or connect production credentials.
4. Verify the payment action.
5. Check the applicable countries.
6. Save the configuration.
7. Perform a controlled live transaction.
8. Verify the resulting Magento order.

Only switch to production after you are confident that the checkout and order workflow operates correctly.

Common PayPal Configuration Problems

PayPal Does Not Appear at Checkout

Check:

• PayPal is enabled.
• Correct website/store scope is selected.
• Applicable countries are correct.
• Currency is supported.
• Account credentials are valid.
• The payment integration is installed and enabled.
• Magento cache has been refreshed.

PayPal Authentication Fails

Incorrect or expired API credentials can prevent Magento from communicating with PayPal.

Verify the API username, password, signature, or certificate as applicable. Adobe’s troubleshooting guidance specifically recommends checking credentials and ensuring that Magento and PayPal settings are consistent. (Experience League)

Sandbox Payment Does Not Work

Check that:

• Sandbox mode is enabled.
• Sandbox credentials are being used.
• The PayPal sandbox account is active.
• You are using sandbox customer credentials for testing.
• Production credentials have not accidentally been entered.

Live Payments Fail

Check:

• Production credentials.
• PayPal account status.
• Payment currency.
• Payment action.
• Country restrictions.
• Magento logs.
• PayPal account configuration.

If Magento’s configuration appears correct but PayPal still rejects transactions, review PayPal’s transaction information and contact PayPal support if necessary.

PayPal Button Does Not Appear

For Payment Services, check whether the relevant PayPal button is enabled for the location where you expect it to appear, such as checkout, cart, mini-cart, or product page. (Experience League)

PayPal Security Best Practices

Follow these practices when configuring PayPal:

• Always use HTTPS.
• Keep Magento updated.
• Keep payment extensions updated.
• Protect API credentials.
• Never share API passwords publicly.
• Use sandbox mode for testing.
• Restrict Magento Admin access.
• Enable SSL verification where appropriate.
• Monitor payment errors and logs.
• Test payment and refund workflows before going live.

Adobe’s PayPal configuration also includes SSL verification and debugging options; debugging should be used carefully and only when troubleshooting is necessary. (Experience League)

Best Practices for Magento PayPal Configuration

For a reliable PayPal checkout:

• Use a suitable business PayPal account.
• Confirm that PayPal supports your merchant country and intended payment setup.
• Test in sandbox mode first.
• Use production credentials only on the live environment.
• Choose the correct payment action.
• Verify supported currencies.
• Test successful and failed transactions.
• Test order creation and invoicing.
• Test refunds where applicable.
• Keep payment modules updated.
• Monitor payment-related errors after launch.

Frequently Asked Questions

Can I use PayPal in Magento?

Yes. Magento and Adobe Commerce support PayPal payment integrations, although the available integration depends on your Magento version and installed modules. (Experience League)

Where can I configure PayPal?

For PayPal Express Checkout, go to:

Stores → Configuration → Sales → Payment Methods → PayPal Express Checkout

For Payment Services, configuration is available through its dedicated settings area. (Experience League)

Should I test PayPal before going live?

Yes. Use PayPal’s sandbox environment where supported and test the complete checkout workflow before accepting real payments.

What is the difference between Sandbox and Production?

Sandbox is a testing environment where transactions do not represent real customer payments. Production is the live environment used for actual transactions.

Why is my PayPal payment failing?

Common causes include incorrect credentials, unsupported currency or country, account restrictions, incorrect sandbox/production settings, or mismatched Magento and PayPal configuration. (Experience League)

Can customers pay without a PayPal account?

This depends on the PayPal product, merchant configuration, customer location, and PayPal’s eligibility rules. Some PayPal integrations can provide guest or card checkout options. (Experience League)

Conclusion

Configuring PayPal gives Magento stores a convenient online payment option and can make checkout easier for customers. The setup process involves selecting the appropriate PayPal integration, connecting the account, configuring payment settings, testing transactions, and finally switching to production.

For the safest implementation, always test PayPal in a sandbox environment first. Verify payment authorization, order creation, invoicing, and refund workflows before accepting live customer payments.