PayPal Setup Guide
Follow the steps below to connect PayPal to your script and enable live payments. PayPal provides your app credentials in the Developer Dashboard under Apps & Credentials, uses webhooks to send payment events to your server, and recommends testing in Sandbox before moving to Live.
Step 1 — Log in to PayPal Developer
Sign in to your PayPal Developer account and open Apps & Credentials.
If you do not already have an app for your website, create a new one by clicking Create App. PayPal uses this area to manage REST API app credentials.
Step 2 — Create your PayPal app
Enter a name for your app.
Use a name that clearly identifies your website or project, so it is easy to recognize later.
Once the app is created, PayPal will show the app details page where your credentials are stored.
Step 3 — Copy your Client ID and Client Secret
On the app details page, you will see information such as:
- Display App Name
- Client ID
- Client Secret
Copy the Client ID and Client Secret and paste them into the PayPal settings area of your script admin panel. The client secret should always be kept private.
Admin panel helper text:
- Client ID: Paste your PayPal Client ID here
- Client Secret: Paste your PayPal Client Secret here
Step 4 — Leave Features as default
You can leave the Features section with its default configuration unless your integration specifically requires other settings.
This keeps the setup simple and avoids unnecessary configuration changes.
Step 5 — Add your webhook
Scroll down to the Live Webhooks section and click Add Webhook.
In the webhook URL field, enter the webhook URL provided by your script.
It will look similar to this:
https://yoursite.com/webhook/paypal/process
PayPal webhooks are HTTPS notifications sent from PayPal to your server whenever selected events occur.
Important note:
Make sure the webhook URL matches exactly the one shown in your admin panel.
Step 6 — Choose webhook events
In the Event types section, select the events your script should track.
If your script is built to handle a broad PayPal integration, you may choose All Events for a simpler setup. PayPal supports multiple webhook event names and lets you subscribe to specific events or broader selections depending on your needs.
Tip:
If you want the easiest setup and your script supports it, choose All Events.
Step 7 — Copy the Webhook ID
After saving the webhook, it will appear in the Live Webhooks section.
You will then see:
- Webhook URL
- Webhook ID
- Events Tracked
Copy the Webhook ID and paste it into the Webhook ID field in your admin panel. PayPal uses the webhook ID later to help verify webhook messages.
Admin panel helper text:
- Webhook ID: Paste the Webhook ID generated by PayPal here
Step 8 — Complete the PayPal settings in your admin panel
Now return to your script admin panel and complete the PayPal configuration:
- Environment: Live
- Client ID: your PayPal Client ID
- Client Secret: your PayPal Client Secret
- Webhook ID: your PayPal Webhook ID
- Brand Name: your website name
- Webhook URL: your webhook endpoint
- Status: Active
For testing, PayPal provides a separate Sandbox environment that simulates production without using real money. After testing is complete, you can move to Live to process real payments.
Step 9 — Save and activate PayPal
Save the changes in your admin panel.
Once your live credentials and webhook details are correctly entered, your PayPal integration will be ready to accept real payments in production. PayPal’s production guidance states that the go-live step comes after testing in Sandbox.
Recommended note for your guide
Important:
We strongly recommend testing your PayPal integration in Sandbox mode first. Once everything works correctly, switch the environment to Live, update your live credentials, and activate PayPal in your admin panel. PayPal documents Sandbox as the testing environment and Live as the production environment for real transactions.