Documentation
LiteShoper PayPal Plugin — Full Guide
On this page
- Overview
- Requirements
- Installation
- Setup
- Tutorial: first PayPal payment
- URLs & webhooks
- Admin reference
- Troubleshooting
Overview
LiteShoper PayPal (liteshop-paypal) adds PayPal Checkout to your store. Customers select PayPal at checkout, approve payment on PayPal.com, and return to your store with the order captured.
Payment flow
- Customer chooses PayPal at checkout
- LiteShoper creates a PayPal order and redirects to PayPal approve URL
- Customer approves → returns to
/commerce/paypal/return - Plugin captures payment → order confirmed
- Webhook
PAYMENT.CAPTURE.COMPLETEDacts as backup if return fails
Requirements
- LiteShoper Commerce (core)
- Marketplace license for
liteshop-paypal - PayPal Business account
- PayPal Developer app (REST API)
Installation
- Purchase on liteshoper.com → copy license key.
- Store admin → Plugins → Marketplace → install liteshop-paypal.
Setup
Admin: Commerce → Settings → PayPal
| Setting | Description |
|---|---|
| Enable PayPal | Show PayPal at checkout |
| Sandbox | Use sandbox Client ID + Secret first |
| Client ID / Secret | From PayPal Developer → Apps |
| Webhook ID | Optional but recommended for signature verification |
| Label | Checkout button text (default “PayPal”) |
PayPal Developer
- developer.paypal.com → Apps → Create app.
- Copy Sandbox Client ID and Secret into LiteShoper.
- Webhooks → Add webhook URL
https://YOUR-STORE.com/commerce/paypal/webhook - Subscribe to
PAYMENT.CAPTURE.COMPLETEDandCHECKOUT.ORDER.COMPLETED. - Copy Webhook ID into LiteShoper settings.
Tutorial: first PayPal payment
- Enable PayPal in sandbox mode.
- Checkout with PayPal — log in with a PayPal sandbox buyer account.
- Approve payment — you return to order confirmation.
- Verify order status confirmed in admin.
URLs & webhooks
| Path | Purpose |
|---|---|
/commerce/paypal/return |
Browser return after approval (GET) |
/commerce/paypal/cancel |
Customer cancelled on PayPal |
/commerce/paypal/webhook |
Server webhook (POST) |
Admin reference
Settings: Commerce → Settings → PayPal. Orders: Commerce → Orders.
Dropship-related orders may redirect to /account/dropship after PayPal payment.
Troubleshooting
- PayPal not available — plugin disabled or credentials missing.
- Authentication failed — wrong Client ID/Secret or sandbox/live mismatch.
- Payment not completed on return — check PayPal app logs; rely on webhook backup.
- Invalid webhook signature — wrong Webhook ID.
- Could not match payment to order — session/token issue; check server logs.