PayPal is a global payment gateway serving over 400 million users worldwide. Once connected to Zanfia, your customers can pay using their PayPal account or with a card via PayPal.
WARNING: PayPal in Zanfia supports one-time payments only. It does not work with subscriptions or recurring payments.
What you need #
- A business account at PayPal
- Access to PayPal Developer Dashboard
- Credentials from Developer Dashboard: Client ID and Client Secret
Step 1: Create an app in PayPal Developer Dashboard #
- Sign in to PayPal Developer Dashboard
- Go to Apps & Credentials
- Make sure the toggle is set to Live (not Sandbox)
- Click Create App
- Enter the app name (e.g. “Zanfia”) and click Create App
- On the app page you will find:
- Client ID, visible immediately
- Client Secret, click “Show” to reveal it
[SCREENSHOT: PayPal Developer Dashboard, Apps & Credentials, Client ID and Secret]
TIP: Copy both keys and store them in a safe place. Client Secret is only revealed after you click “Show”.
Step 2: Connect PayPal in Zanfia #
- In Zanfia go to Settings, Payment gateways
- Find the PayPal section and click Add account
- Fill out the form:
- Client ID, from PayPal Developer Dashboard
- Client Secret, from PayPal Developer Dashboard
- Click Save
[SCREENSHOT: Zanfia, Settings, Payment gateways, PayPal form]
Zanfia will automatically verify your credentials by connecting to PayPal API. If the data is correct, the status will change to “Connected”.
Step 3: Enable PayPal on a product #
After connecting the gateway you have to enable PayPal on the prices of a specific product:
- Go to Products and pick a product
- Open the price settings
- In the payment gateways section check PayPal
- Save the changes
[SCREENSHOT: Zanfia, product price settings, payment gateways, PayPal]
TIP: When connecting PayPal you can tick the option to automatically enable it on all existing prices.
How it looks for the customer #
Once PayPal is enabled, your customer will see the “PayPal” option with the logo at checkout. Purchase flow:
- Customer picks PayPal at checkout
- After clicking “Buy” they are redirected to the PayPal page
- They sign in to their PayPal account (or pay by card via PayPal)
- They confirm the payment by clicking “Pay now”
- They land on the Zanfia thank-you page
- They receive a purchase confirmation email with login details
Supported currencies #
PayPal in Zanfia supports:
- PLN (Polish zloty)
- EUR (euro)
- USD (US dollar)
- GBP (British pound)
Limitations #
| Feature | Status |
|---|---|
| One-time payment | Yes |
| Subscription / recurring payment | No |
| Installments | No |
| PLN / EUR / USD / GBP | Yes |
| Discount codes | Yes |
| Access renewal (one-time) | Yes |
Troubleshooting #
Error when connecting PayPal #
Check that:
- You are copying the credentials from Live mode (not Sandbox) in Developer Dashboard
- Client ID and Client Secret are copied without extra spaces
- Your PayPal account is a Business account, not a personal one
Customer does not see the PayPal option at checkout #
- Check that PayPal is connected in Settings, Payment gateways
- Check that PayPal is enabled in the product price settings
PayPal does not show up for subscriptions #
PayPal does not support recurring payments. If a price has type “subscription” or “installments”, PayPal will not appear at checkout. Use a one-time price or a different gateway (Stripe, PayU).
Disconnecting PayPal #
- Go to Settings, Payment gateways
- Click Disconnect next to PayPal
- Confirm disconnection
Disconnecting the gateway does not affect already completed transactions.
