PayPal Configuration Reference
Quick reference for PayPal payment gateway settings.
Step-by-Step Tutorials
For complete setup instructions, see:
- PayPal Sandbox Setup — Development and testing
- PayPal Live Mode Setup — Production payments
Settings Overview
Located at PaywallWP → Settings → Payments → PayPal
| Setting | Description |
|---|---|
| Mode | Disabled, Sandbox, or Live Mode |
| Client ID | Your PayPal app Client ID |
| Client Secret | Your PayPal app Secret |
| Webhook ID | Your webhook identifier |
API Credentials
Get credentials from PayPal Developer Dashboard → Apps & Credentials
| Environment | Dashboard URL |
|---|---|
| Sandbox | https://developer.paypal.com/dashboard/applications/sandbox |
| Live | https://developer.paypal.com/dashboard/applications/live |
Webhook URL
https://yoursite.com/wp-json/paywallwp/v1/paypal-webhook
Add webhooks in your PayPal app settings under "Webhooks" section.
Required Events
| Event | Purpose |
|---|---|
BILLING.SUBSCRIPTION.ACTIVATED | New subscription |
BILLING.SUBSCRIPTION.CANCELLED | Cancellation |
BILLING.SUBSCRIPTION.EXPIRED | Expiration |
BILLING.SUBSCRIPTION.SUSPENDED | Payment failure |
PAYMENT.SALE.COMPLETED | Payment received |
PAYMENT.SALE.REFUNDED | Refund |
Sandbox Test Accounts
Access at Developer Dashboard → Sandbox → Accounts
| Type | Purpose |
|---|---|
| Business | Merchant account (create plans, receive payments) |
| Personal | Buyer account (test purchases) |
Test Cards (in Sandbox)
| Card | Number |
|---|---|
| Visa | 4111111111111111 |
| Mastercard | 5555555555554444 |
| Amex | 378282246310005 |
Use any future expiry and any CVV.
Useful Links
| Resource | URL |
|---|---|
| Developer Dashboard | https://developer.paypal.com/dashboard/ |
| Sandbox Apps | https://developer.paypal.com/dashboard/applications/sandbox |
| Live Apps | https://developer.paypal.com/dashboard/applications/live |
| Sandbox Accounts | https://developer.paypal.com/dashboard/accounts |
| Sandbox PayPal | https://www.sandbox.paypal.com/ |
| Webhook Simulator | https://developer.paypal.com/dashboard/webhooksSimulator |
Troubleshooting
| Issue | Solution |
|---|---|
| Invalid Client ID | Check sandbox vs live mode matches |
| Popup blocked | Allow popups from your site |
| Webhook not receiving | Verify Webhook ID (not Client ID) |
| Subscription not activating | Check webhook delivery status |
For detailed troubleshooting, see the Troubleshooting Guide.