Help Center › Locations & Multi-Clinic › Connecting a clinic's PayPal account

Connecting a clinic's PayPal account

Updated November 17, 2026 · Locations & Multi-Clinic
Experimental add-onLocations: PayPal is off by default and lives behind Experimental Features. How to turn it on.

A clinic connects its own PayPal Business account from My Account → My Clinic, on the Location PayPal Account card in the clinic's Settings section. Only the clinic's primary contact can connect, re-check or disconnect. Other staff see the card and its status, with the line “Only the location's primary contact can manage the PayPal connection.”

No card at all? It stays hidden until the store admin has saved the Partner Merchant ID and Partner Client ID under WooCommerce → Settings → Payments → PayPal Location Based (Qualiphy) → Configuration. Staff with no My Clinic tab aren't assigned to the clinic, or are signed in with another account (see Clinic logins, staff invites, and sales tracking).

Connect PayPal

  1. Sign in as the clinic's primary contact and open My Account → My Clinic → Settings.
  2. On the Location PayPal Account card, click Connect PayPal. If you see “Your browser blocked the PayPal window.”, allow pop-ups for the store and try again.
  3. At PayPal, sign in with (or sign up for) the clinic's PayPal Business account and grant every permission PayPal asks for.
  4. Back on the store, the card checks the account with PayPal. It shows Connected once PayPal confirms the account can receive payments, has granted the permissions and has a confirmed email address. If something is still missing, finish it in the clinic's PayPal account and click Re-check status.

The connect link

Each connect link lasts 14 days and works once. Generating a new link replaces the old one, and a link only works for the person who generated it. Since 1.2.5, a Connect PayPal link that fails shows a clear message saying why:

  • “The PayPal link for this location has expired. Generate a new link to continue.” Click Generate new link on the card.
  • “This PayPal link can't be used.” It was already used, was replaced by a newer link, or was opened by a different user. Start again from the card, signed in as the primary contact.

What each status means

StatusWhat it means
Not connectedThe clinic hasn't started connecting PayPal. Click Connect PayPal.
Ready to connectA connect link has been generated. Open it and finish the steps at PayPal, or click Generate new link if it has expired.
Finishing setupPayPal hasn't confirmed everything yet: the account can't receive payments, a permission is missing, or the email address isn't confirmed. Finish those steps in PayPal, then click Re-check status.
ConnectedPayPal confirmed the account. Customers who pick this clinic can pay with PayPal, and by card if the clinic is set up for cards.
DisconnectedThe account can no longer take payments here, for example because PayPal says it can no longer be charged. Reconnect from the card.
Connection errorThe last attempt to connect or check the account didn't go through. Try again; if it keeps happening, ask the store admin to check the PayPal settings.

Until a clinic is connected, customers who pick it can't pay with PayPal. If PayPal doesn't answer a status check, nothing changes: you see “We couldn't reach PayPal to check this account. Nothing was changed.” Try again in a few minutes.

Card payments need their own permission

Card processing is a separate permission at PayPal, so a clinic can be connected for PayPal payments but not cards. The card then shows an Enable card payments prompt, and the primary contact reconnects once through it. Until PayPal confirms the new connection, the clinic keeps taking payments on its current account. Customers see the card option once the clinic is card-ready and the store admin has turned on Enable Credit or Debit Card on the payment method's Credit Card tab.

Daily checks and disconnects

Every day the store re-checks each clinic that is connected, still finishing setup, in error, has an open link, or was disconnected by PayPal. If PayPal says a connected account can no longer be charged, the clinic changes to Disconnected. When a clinic withdraws the store's permission inside PayPal, PayPal tells the store, the clinic is re-checked, and the admin gets the alert “A clinic's PayPal account was disconnected”. Either way, the primary contact reconnects from My Clinic.

The primary contact can also disconnect from the card. New PayPal payments to the clinic are blocked at checkout until it reconnects, and past payments and refund history are kept.

When the store keeps a platform fee, the card also shows the clinic the fee rates (see Platform fees on clinic PayPal payments).

For store admins: PayPal on the Locations list

On Qualiphy → Locations, each clinic's row carries a PayPal badge. Hover it for a plain-language explanation, for example “PayPal is not connected. Customers picking this clinic can't pay with PayPal.” or “Last PayPal status check failed. Customers picking this clinic can't pay with PayPal until it re-verifies.” Use the PayPal filter above the list to find clinics by PayPal status, such as those showing an error.

Related

Still stuck? We're quick to respond.

Email [email protected]. Available 7 days a week, 7 AM to 6 PM PT.