Skip to main content

PayPal Configuration Reference

Quick reference for PayPal payment gateway settings.

Step-by-Step Tutorials

For complete setup instructions, see:

Settings Overview

Located at PaywallWP → Settings → Payments → PayPal

SettingDescription
ModeDisabled, Sandbox, or Live Mode
Client IDYour PayPal app Client ID
Client SecretYour PayPal app Secret
Webhook IDYour webhook identifier

API Credentials

Get credentials from PayPal Developer Dashboard → Apps & Credentials

EnvironmentDashboard URL
Sandboxhttps://developer.paypal.com/dashboard/applications/sandbox
Livehttps://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

EventPurpose
BILLING.SUBSCRIPTION.ACTIVATEDNew subscription
BILLING.SUBSCRIPTION.CANCELLEDCancellation
BILLING.SUBSCRIPTION.EXPIREDExpiration
BILLING.SUBSCRIPTION.SUSPENDEDPayment failure
PAYMENT.SALE.COMPLETEDPayment received
PAYMENT.SALE.REFUNDEDRefund

Sandbox Test Accounts

Access at Developer Dashboard → Sandbox → Accounts

TypePurpose
BusinessMerchant account (create plans, receive payments)
PersonalBuyer account (test purchases)

Test Cards (in Sandbox)

CardNumber
Visa4111111111111111
Mastercard5555555555554444
Amex378282246310005

Use any future expiry and any CVV.

ResourceURL
Developer Dashboardhttps://developer.paypal.com/dashboard/
Sandbox Appshttps://developer.paypal.com/dashboard/applications/sandbox
Live Appshttps://developer.paypal.com/dashboard/applications/live
Sandbox Accountshttps://developer.paypal.com/dashboard/accounts
Sandbox PayPalhttps://www.sandbox.paypal.com/
Webhook Simulatorhttps://developer.paypal.com/dashboard/webhooksSimulator

Troubleshooting

IssueSolution
Invalid Client IDCheck sandbox vs live mode matches
Popup blockedAllow popups from your site
Webhook not receivingVerify Webhook ID (not Client ID)
Subscription not activatingCheck webhook delivery status

For detailed troubleshooting, see the Troubleshooting Guide.