Per-clinic PayPal payouts (Locations: PayPal)
Locations: PayPal (also called Location Based PayPal Connect) lets each clinic connect its own PayPal Business account, so patient payments go straight to the clinic the order belongs to. Patients pay by PayPal or by card, for one-time orders and subscriptions, and your site can keep a platform fee on each payment. Your own platform PayPal account facilitates the payment but doesn't receive the clinic's money, apart from that fee.
What you need
- The Locations add-on, with your clinics set up.
- Your site's own PayPal partner details: a Partner Merchant ID, a Partner Client ID, and the client ID and secret of a Partner Referrals REST app.
- A PayPal Business account for each clinic, able to receive payments.
- Your site on https, so PayPal can send updates to it.
- WooCommerce Subscriptions, if you sell subscriptions.
Turn it on
- Go to Qualiphy → Settings → General, turn on Advanced Settings, then turn on Experimental Features. The Experimental Features toggle only shows while Advanced Settings is on.
- Go to Qualiphy → Add-Ons. Make sure Locations is on, then enable Locations: PayPal. Its card carries an “Experimental” pill and a “PayPal Merchant Account Required” note.
- Go to WooCommerce → Settings → Payments → PayPal Location Based (Qualiphy), enter your partner details on the Configuration tab, and turn the payment method on from the PayPal tab.
- Ask each clinic's primary contact to connect PayPal from My Clinic. See Connecting a clinic's PayPal account.
The Add-Ons page won't turn Locations: PayPal on while Experimental Features is off.
Turning it off
Turning off Experimental Features or the Locations add-on also switches Locations: PayPal off, and the payment method disappears from checkout. Its settings and clinic connections are kept for when you turn it back on. If your store has paid PayPal orders or active PayPal subscriptions at that point, every Qualiphy admin page shows “Locations: PayPal is turned off.” with the counts, because while it's off:
- those orders can't be refunded to PayPal from WooCommerce,
- those subscriptions won't be charged at their next renewal, and
- refunds and disputes made at PayPal aren't picked up.
The payment method's settings
Everything lives on WooCommerce → Settings → Payments → PayPal Location Based (Qualiphy). The old PayPal Connect card on Qualiphy → Settings was removed in 1.2.5, and old links to it open this page.
| Tab | What it holds |
|---|---|
| PayPal | Turns the payment method on and sets the title and description customers see (the title defaults to “PayPal”). |
| Credit Card | Enable Credit or Debit Card (off by default) and the card option's title and description. Each clinic must also be set up for cards. |
| Configuration | Your Partner Merchant ID and Partner Client ID, and the Partner Referrals REST app client ID and secret that every PayPal request uses. The payment method stays hidden until the client ID and secret are saved, and clinics don't see their PayPal card until both partner IDs are saved. Changing the client ID later means every clinic has to reconnect. The PayPal webhook block is here too. |
| Fees | The platform fee switch and rates, with their own Save button. See Platform fees on clinic PayPal payments. |
| Settings | An optional BN Code (a PayPal partner attribution code), and debug logging for PayPal and card activity, which you read under WooCommerce → Status → Logs. |
The PayPal webhook
PayPal tells your site about refunds made at PayPal, disputes, chargebacks, payments it was reviewing, and clinics that withdraw their permission. One webhook address covers every clinic. The add-on registers it at PayPal on its own, re-checks it daily, and leaves other addresses on your PayPal app alone. Nothing PayPal sends is acted on until PayPal confirms it really came from PayPal.
The PayPal webhook block on the Configuration tab shows whether your site's address is registered, a Register now button, and What PayPal sent lately. When the address isn't registered, the block says why: the site isn't on https (PayPal only calls https addresses), the PayPal details are missing, there's no room on the PayPal app (“Not registered: no room on the PayPal app”), or PayPal refused (“Not registered: PayPal refused”). Fix the cause, then click Register now.
Turn off other payment methods
Clinics only get paid through PayPal Location Based (Qualiphy). While the add-on is on and any other WooCommerce payment method is enabled, wp-admin shows a notice that can't be dismissed. The other methods still take payments, but that money goes to your store's own account, not the clinic's. Disable the other payment methods, or keep them on knowing those orders won't pay the clinic. For general gateway rules, see Payment gateway requirements.
How the money flows
- The patient picks a clinic in the clinic picker. The payment method is only offered for a clinic that has connected PayPal.
- The payment is made out to the clinic's own PayPal account, with your platform fee attached if you set one.
- PayPal pays the clinic directly, and the fee goes to your site's partner account (the Partner Merchant ID).
- The order screen shows who was paid (PayPal Payee), and the order totals gain Platform fee retained and Clinic payout rows.
- Subscription renewals are charged the same way, to the clinic saved on the subscription.
- Refunds go back through the clinic's PayPal account and lower the fee you keep.
More about Locations: PayPal
Still stuck? We're quick to respond.
Email [email protected]. Available 7 days a week, 7 AM to 6 PM PT.