Skip to main content
PayPal is a global payment service provider that lets businesses accept online payments through PayPal and other eligible funding options. You can connect your PayPal merchant app to a Readdy project and ask AI to add a secure payment flow to your website. Once connected, Readdy can generate PayPal checkout buttons for one-time payments, create and capture payments securely, and update the corresponding order in your connected database.
PayPal Integration

​
Before You Start

This guide will walk you through connecting PayPal to your Readdy project. Before you begin, make sure you have the following ready:
Readdy currently supports one-time PayPal payments. Subscriptions, automatic billing, refunds, payouts, marketplace payments, and platform fees are not included in this integration.
Once these are ready, let’s connect PayPal.

​
Get Your PayPal App Credentials

1

Open the PayPal Developer Dashboard

Go to the PayPal Developer Dashboard, sign in, and open “Apps & Credentials”.
Apps and Credentials page in the PayPal Developer Dashboard
2

Choose the Environment

Select “Sandbox” while building and testing your website, or “Live” when you are ready to accept real payments.
Sandbox payments use test accounts and do not move real money. Live payments are processed through your PayPal Business account.
Sandbox and Live environment selector in the PayPal Developer Dashboard
3

Create a Merchant App

Open the “Apps & Credentials” tab.
Apps and Credentials page in the PayPal Developer Dashboard
Click “Create App”, enter an app name, and choose “Merchant” as the app type. If PayPal asks you to select a Sandbox account, choose a Sandbox Business account.
Creating a Merchant app in the PayPal Developer Dashboard
4

Copy the App Credentials

Open the app, then copy its Client ID and Client Secret. If the secret is hidden, click “Show” before copying it.
App credentials for a PayPal Merchant app
Choose “Merchant”, not “Platform”. Platform apps are designed for partner onboarding, marketplaces, platform fees, and multiparty payments, which Readdy’s current PayPal integration does not support.
The Client ID and Client Secret must come from the same app and the same environment. Do not combine a Sandbox credential with a Live credential.
Readdy accepts both Sandbox and Live credential pairs and detects the environment automatically. You do not need to choose an environment in Readdy or manually add PayPal secrets to Supabase. For more information about PayPal credentials, see the PayPal REST API authentication guide.

​
Connect PayPal in Readdy

1

Open the Connects Panel

In the Readdy editor, click “Connects” at the top of the screen.
Connects button at the top of the Readdy editor
2

Select PayPal

Find “PayPal” in the Connects panel, then click “Connect”.
PayPal integration in the Readdy Connects panel
If your project does not have a connected database, Readdy asks you to connect Readdy Backend or Supabase first. PayPal uses the connected backend to validate order amounts, create orders, keep the Client Secret secure, and confirm payments.
3

Enter Your App Credentials

Paste the matching Client ID and Client Secret, then click “Connect”.
Client ID and Client Secret fields in the Readdy PayPal connection panel
4

Confirm the Connection

Check that the panel displays “Connected” and masks both credentials.
PayPal connected in Readdy with masked credentials
5

Ask Readdy to Add the Payment Flow

Ask Readdy AI to add PayPal to the products, cart, or checkout button on your website. Clearly describe where PayPal should appear and what should happen after a successful payment.For example:
Add PayPal as a payment option on my cart checkout. Let the customer approve the payment and show the order confirmation only after the payment is verified.
Example website with a PayPal checkout flow

​
Best Practices

  • Tell Readdy AI which products, cart, or checkout button should use PayPal.
  • Start with Sandbox credentials and test the complete customer journey through your website’s share link or published URL before switching to Live.
  • Keep your Client Secret private. Never paste it into chat, generated page code, or a public repository.
  • Verify the payment amount, currency, and order status before fulfilling an order.
  • If you change credentials, regenerate and republish your website before sending customers to checkout again.
Readdy provides the PayPal integration but does not participate in payment processing or hold your funds. You receive funds directly through your PayPal Business account. If Readdy and PayPal show different payment records, verify the payment in PayPal before fulfilling or refunding the order.

​
FAQ

Create a Merchant app. Readdy uses your own PayPal Business account to process payments directly for your store. Platform apps are intended for marketplaces, partner onboarding, platform fees, and multiparty payments.
Make sure the Client ID and Client Secret come from the same Merchant app and the same Sandbox or Live environment. Open the app in “Apps & Credentials”, copy both complete values again, and retry the connection.
Yes. Readdy accepts both Sandbox and Live credentials and detects the environment automatically. Sandbox payments are for testing and do not move real money.
Readdy uses the connected backend to validate order amounts, create orders, protect your Client Secret, confirm payments with PayPal, and update the order only after payment succeeds.
No. The website receives only the public Client ID. The Client Secret remains in the connected backend and is used only by server-side payment functions.
PayPal decides which eligible account and funding options to display based on your merchant setup, the buyer, currency, country, and PayPal availability.
Open “Connects”, select “PayPal”, and click “Change credentials”. Enter the new matching pair, then regenerate and republish your website so its public Client ID matches the newly connected app.
Shopify products continue through Shopify Checkout. This PayPal integration is for products and orders managed through Readdy Backend or Supabase.

​
Need Help?

If this guide doesn’t resolve your issue, submit a support ticket. We’re here to help!