PayPal Sandbox Setup - softerfish/fyuhls GitHub Wiki
This page is the short, testing-first version of the PayPal setup flow in fyuhls.
Use it when you want to get PayPal sandbox working before you worry about live credentials.
Go to:
- Admin -> Config Hub -> Monetization
In Payment Gateways, fill in:
- Enable PayPal Checkout
- Client ID
- Client Secret
- Webhook ID
- Use PayPal Sandbox
PayPal is only treated as ready when:
- Enable PayPal Checkout is turned on
- Client ID is saved
- Client Secret is saved
Important:
- Use PayPal Sandbox does not enable PayPal by itself
- it only tells fyuhls to use the sandbox PayPal environment
- Open the PayPal developer dashboard
- Go to Apps & Credentials
- Stay on the Sandbox tab
- Create a sandbox app or open an existing one
- Copy:
- Client ID
- Secret
Paste them into fyuhls:
- Client ID -> PayPal client ID
- Secret -> PayPal client secret
Make sure this is checked:
- Use PayPal Sandbox
Then turn on:
- Enable PayPal Checkout
Save Config Hub.
- In the same PayPal sandbox app, open Webhooks
- Create a webhook that points to:
https://yourdomain.com/payment/callback/paypal
- After saving it, PayPal shows a webhook identifier
- Copy that value into:
- Webhook ID
The webhook must belong to the same sandbox app/environment as the sandbox client credentials.
After saving the sandbox credentials:
- open a paid package in fyuhls
- start checkout with PayPal
- approve it in sandbox
- return to fyuhls
- confirm the package was applied
Also test:
- canceling at PayPal
- one later webhook-driven status update in your broader payment testing
Usually one of these is true:
- Client ID is blank
- Client Secret is blank
- Enable PayPal Checkout is still off
Usually one of these is true:
- the sandbox app credentials are wrong
- live credentials were pasted while sandbox mode is still on
- PayPal checkout was enabled without valid credentials
Usually caused by:
- wrong callback URL
- wrong webhook environment
- missing or wrong Webhook ID