How to Connect Your Own PayPal Account
| Feature Availability | User Permissions | Time to Complete | Skill Level |
|---|---|---|---|
| Philippine and US stores on Launch, Grow, Scale and Trial. Not available on Free | Store owner, or a team member with Billing access | About 15 minutes | Intermediate |
Summary
Overview: If you have a PayPal Business account, you can connect it to your store with the Client ID and Secret of a PayPal REST app. Customers then pay on PayPal's secure page, and the money goes straight into your own PayPal account. Both Philippine and US stores can use it.
Prerequisites:
- A Philippine or US store on the Launch, Grow, Scale or Trial plan.
- Store owner access, or a team member with Billing access.
- A PayPal Business account.
- A REST app in the PayPal developer dashboard, with its Client ID and Secret.
Step-by-Step Instructions
Step 1: Open the PayPal page
- In the sidebar, click Settings, then Payments.
- Under Prosperna Payments, find the PayPal card. Before you connect, it shows Not Connected.
- Click Manage.
The PayPal page opens.
Step 2: Get your Client ID and Secret from PayPal
The page lists these steps under Where to find these credentials:
- Log in at developer.paypal.com with your PayPal Business account.
- Create a REST app under Apps and Credentials.
- Copy the Client ID and Secret.
Make sure you copy them from the Live side of the PayPal developer dashboard. Sandbox credentials only work with PayPal's test accounts.
Step 3: Connect your credentials
- Under Environment, keep Live selected. Sandbox is only for testing with PayPal sandbox accounts. If you connect Sandbox credentials, PayPal still appears at your checkout, but customers are sent to PayPal's test site and can't pay you real money. Only use Sandbox when your store isn't taking real orders.
- Paste your Client ID.
- Paste your Client Secret.
- Click Connect. Prosperna checks your credentials with PayPal before saving them, so this can take a few seconds.
- When it works, you see PayPal account connected.
To leave without connecting, click Back.
Step 4: Check your connection details
After you connect, the page shows:
- a Connected badge and Your PayPal account is verified and connected.
- Environment: Live or Sandbox
- Client ID ending with the last four characters of your Client ID
- Connected on with the date
Your Secret is never shown again after you save it. Prosperna also adds a payment webhook to your PayPal app automatically, so you don't need to add one yourself.
Step 5: See what your customers get at checkout
- On your store's checkout page, customers see a payment option called PayPal.
- When they choose it, they see You'll be redirected to a secure payment page to complete your order.
- After they place the order, they go to PayPal and pay with their PayPal account or another method PayPal offers them.
Step 6: Follow your PayPal orders
You don't need to confirm PayPal payments yourself. Prosperna updates each order automatically:
- When the order is placed: the payment status is Awaiting Payment.
- When the customer pays: the payment status changes to Paid, stock is updated and the customer gets an order confirmation email.
- Orders with physical products shipped by a courier (Standard Delivery, Same Day Delivery, Scheduled Delivery or USPS) move to Processing. For Store Pickup and Manual Shipping orders, update the order status yourself as usual.
- Orders that contain only digital products move to Completed.
- When the payment is declined or the customer doesn't pay: if PayPal declines the payment, or the PayPal payment expires, the payment status changes to Declined Payment.
- When PayPal can't create the payment: the order is cancelled automatically and its payment status is Declined Payment.
Prosperna checks PayPal every 15 minutes for orders from the last 3 days that are still waiting, so an order is updated even if a payment notice from PayPal is missed.
Payments go straight to your PayPal account. They are not added to your Prosperna balance. Manage payouts and refunds in your PayPal account.
Step 7: Update your credentials (optional)
- Open the PayPal page again (Step 1).
- Click Update credentials.
- Choose the Environment, and paste the Client ID and Client Secret again. Use the same ones to re-check them, or new ones to switch to another REST app.
- Click Save. To close the form without changes, click Cancel.
If you change or delete your app's Secret in PayPal, PayPal stops accepting the old one. Update your credentials here right away, or customers can't pay with PayPal.
Step 8: Disconnect your PayPal account (optional)
- Open the PayPal page (Step 1).
- Click Disconnect.
- In the Disconnect PayPal account window, read the message: customers will no longer be able to pay through your PayPal account, and your credentials will be removed.
- Click Disconnect. You see PayPal account disconnected.
The PayPal option disappears from checkout. You can connect again at any time by repeating Step 3.
Verify It Worked
Success criteria:
- You saw PayPal account connected.
- The PayPal page shows the Connected badge and Environment: Live.
- Back on Settings → Payments, the PayPal card shows Connected.
- On your store's checkout page, PayPal appears as a payment option.
Troubleshooting
Common errors
- "Please enter your PayPal Client ID." or "Please enter your PayPal Client Secret.": one of the boxes is empty. Paste both and click Connect again.
- "PayPal rejected these credentials. Check the Client ID/Secret and that you picked the right environment (Live vs Sandbox).": PayPal didn't accept them. Copy both again, and check that Environment matches where you copied them from (Live or Sandbox).
- "We could not validate these credentials with PayPal right now. Please try again.": Prosperna couldn't reach PayPal. Wait a moment and try again.
- "Your PayPal credentials work, but we could not register the payment webhook on your PayPal app. Please try again.": the credentials are fine, but adding the payment webhook failed. Try again.
- "Your PayPal app already has 10 webhooks — remove one in the PayPal developer dashboard and reconnect.": PayPal allows only 10 webhooks per app. Delete one you no longer use in the PayPal developer dashboard, or create a new REST app, then connect again.
- "Failed to disconnect.": the account was not disconnected. Try again.
- The PayPal page shows "Connection broken" and "PayPal rejected the credentials saved here. Re-enter your credentials to reconnect.": PayPal no longer accepts the credentials you saved, usually because the app's Secret was changed or the app was deleted. Customers can't choose PayPal until you fix it, and orders that are still waiting for payment aren't updated until you do. Click Re-enter credentials, paste your current Client ID and Secret, and click Save.
- A customer sees "We could not start the payment with this gateway. Please try another payment method.": PayPal couldn't create the payment for that order, so the order was cancelled automatically. Check the PayPal page for a Connection broken badge.
- A customer paid after the order was cancelled: the order stays Cancelled. A note on the order asks you to refund the customer from your PayPal account.
Limitations & considerations
- PayPal accepts payments in Philippine pesos (PHP) and US dollars (USD).
- Which ways to pay customers see on PayPal's page depends on PayPal and the customer's PayPal account, not on Prosperna.
- You can't change the payment status of these orders by hand. Prosperna updates it from PayPal.
- Refunds aren't made from Prosperna. Refund the customer from your PayPal account.
- PayPal isn't offered for QR menu (table) orders.
- If you book a Prosperna courier for one of these orders, the delivery fee is paid from your Shipping Credits.
Next Steps & Related Resources
- Next steps:
- Related articles:
Need more help? For more information and assistance, please send an email to support@prosperna.com.
Last Updated: 11/19/2026