Payment GatewaysPayPal

PayPal

Connect PayPal to PayLexer to accept card payments, PayPal accounts, digital wallets, and buy now pay later options across 200+ countries.

PayPal is a global digital payments platform supporting wallets and international transactions. It operates in over 200 countries and regions, offering card payments, PayPal account payments, digital wallets, and buy now pay later options for businesses of all sizes.

  • Supported Regions (Merchant Accounts): 200+ countries including the United States, Canada, Europe, the UK, Australia, Asia, Latin America, and the Middle East - view full list
  • Supported Currencies: 25+ currencies including USD, EUR, GBP, CAD, AUD, JPY, and SGD - view full list

This guide walks you through connecting PayPal to PayLexer, configuring API credentials and webhooks, and testing transactions before going live.

Supported Features

  • One-time payments
  • Refunds
  • Real-time payment status updates
  • Multiple payment methods (PayPal account, cards, Venmo, Pay Later)
  • Subscription billing (if enabled)
  • Buyer and seller protection

Before You Start

Make sure you have:

Looking for a different payment processor? View all supported gateways →

Configuring PayPal

You need a Client ID and Secret Key from PayPal for this integration.

Getting API Credentials

Open the PayPal Developer Dashboard

Log in to your PayPal Developer Dashboard.

Select an environment

Select the Sandbox or Live environment tab.

Create an app

Go to Apps & Credentials and click Create App. Enter your app name and click Create App again to confirm.

Copy your credentials

Copy your Client ID and Secret Key.

PayPal issues separate credentials for Sandbox (test) and Live (production) environments. Create an app in both environments to enable full testing.

Adding Credentials to PayLexer

Open PayLexer Dashboard

Log in to your PayLexer dashboard and navigate to Payment Gateways → PayPal.

Enter your credentials

Paste the Client ID and Secret Key you copied from PayPal.

Understanding Live/Production and Sandbox Settings:

EnvironmentPurpose
Live / Production (Mandatory)Used for real transactions. Cannot be empty, even when testing.
Test / Sandbox (Optional)Used for testing only. No real money is processed.

How PayLexer selects credentials:

  • Debug/Test mode ON → Test credentials are used
  • Debug/Test mode OFF → Live credentials are used

Test and save

Click Save to save your configuration and verify your credentials. Click Verify Connection to test the connection.

Configuring Webhooks (Mandatory)

Webhooks enable real-time payment updates and significantly improve reliability.

Benefits of Webhooks:

  • Instant payment status updates
  • Automatic refund processing
  • Dispute notifications
  • Real-time subscription updates

Open the PayPal Developer Dashboard

Log in to your PayPal Developer Dashboard and go to Apps & Credentials.

Add a webhook

Select your app, scroll to the Webhooks section, and click Add Webhook.

Enter the webhook URL

Copy the Webhook URL from PayLexer, paste it into the Webhook URL field, select the event types you want to receive, then click Save.

Copy the Webhook ID

Copy the Webhook ID PayPal generates, paste it into PayLexer, then click Save Configuration.

PayPal uses a Webhook ID for verification, not a Webhook Secret. It performs signature verification automatically, so no additional secret key is needed.

Integrate PayPal to Your Website

If you have already added and configured your site, you can enable PayPal in your existing setup.

Go to Websites

Navigate to Websites in your PayLexer dashboard.

Edit your website

Click the Edit Icon of your added website.

Enable PayPal

Click the checkbox to enable PayPal for the website.

If you haven't added a website yet, Continue to Add Your Website →

Troubleshooting

Best Practices

  • Test in Sandbox before enabling Live mode
  • Confirm webhooks are working before going live
  • Validate the first live transaction after switching
  • Monitor the gateway dashboard for failed payments
  • Keep API credentials secure
  • Use separate Sandbox and Live credentials
  • Enable Debug/Test mode during testing and use only PayPal Sandbox accounts, saving Sandbox credentials in PayLexer, not just Live credentials
  • Enable PayPal Seller Protection for eligible transactions

FAQs

Still Have Questions?

Was this page helpful?