Help Center › Locations & Multi-Clinic › PayPal and card payments at checkout and on subscriptions

PayPal and card payments at checkout and on subscriptions

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.

Customers pay through one payment method, PayPal Location Based (Qualiphy), which offers PayPal and, when the clinic is set up for it, a credit or debit card. Every payment is made out to the PayPal account of the clinic chosen for the order, so that clinic is paid directly, with your platform fee taken from the same payment if you set one.

At checkout

  • The method is offered for the clinic the customer has selected (see Using the clinic picker and clinic links) once that clinic has connected PayPal, and the clinic is checked again when the customer pays. It works on both the classic and the block checkout.
  • PayPal comes first, with a Continue with PayPal button. When card payments are on and the clinic can take cards, the card form sits under the second choice.
  • Choosing PayPal sets the order to Pending with the note “Awaiting PayPal approval.”, sends the customer to PayPal, and takes the payment when they come back.
  • If no clinic is set when the customer pays, they see “Please select a clinic before completing checkout with PayPal.” They pick a clinic and try again. If the clinic hasn't connected PayPal, the payment is refused and the customer is asked to choose another clinic or payment method.
  • When a customer tries again after a failed attempt, the plugin first asks PayPal whether the earlier try went through, so nobody is charged twice.

Card payments

The card form uses PayPal's own secure card fields. Customers see it when Enable Credit or Debit Card is on (on the payment method's Credit Card tab) and the clinic has card payments enabled at PayPal.

  • 3-D Secure: before charging, the plugin checks the bank's verification result. A failed or rejected check is refused, and an inconclusive one asks the customer to try again: “Your bank couldn't verify this card. Please try again or use a different card.”
  • Attempt limits: card attempts are limited per IP address and per checkout session within a 5-minute window. Customers who hit the limit see “Too many attempts. Please wait a few minutes…”
  • Not available: when card payments can't be offered (the add-on or card payments are off, or the clinic can't take cards), customers see “Card payments are not available right now.” A card payment for a clinic that can't take cards is refused with “Card payments are not available for this order.” These messages never say which check failed.

Paying an existing order by card

A customer can pay an unpaid order by card from its payment page (the “pay for order” link). The payment goes to the clinic already on the order.

Subscriptions

Subscriptions need WooCommerce Subscriptions. The customer's PayPal account or card is saved at the first payment and used for renewals.

  • Free trials and fully discounted first payments: nothing is charged. The payment method is saved and the order gets the note “Payment method saved with PayPal for later payments… Nothing was charged today.” The first renewal charges it.
  • Renewals: PayPal and card renewals are both charged without the customer, to the clinic saved on the subscription.
  • No answer from PayPal: the renewal order goes On hold (not Failed) so the customer isn't charged twice, the admin is alerted, and the order note says “PayPal didn't answer when this renewal… was charged”. Check the clinic's PayPal account: if the payment is there, mark the order as paid; if not, set it to Failed so the renewal can be retried.
  • Refused as not authorized: the admin gets the alert “PayPal refused a renewal as not authorized”. Check that the clinic is still connected on My Clinic and that your PayPal partner details are still valid.
  • Bank wants the customer present: a card renewal can fail with “issuer requires additional authentication”. The customer updates the payment method from My Account, as below.

Changing a subscription's payment method

Customers change it themselves from My Account → Subscriptions → Change payment, choosing a new PayPal account or card. Nothing is charged, and they see “Your payment method was updated.” The subscription switches only after PayPal confirms the new method is saved, and the old saved method is then removed at PayPal. It works one subscription at a time, using that subscription's clinic. Admins can't change it for the customer from wp-admin; that option is deliberately not offered.

If a renewal-failure note says the customer must “cancel and re-subscribe”, that wording is outdated. Changing the payment method from My Account is the fix.

Orders PayPal is reviewing

If PayPal holds a payment for review, the order goes On hold with a note not to fulfill it yet. An hourly check moves it on when PayPal decides, and keeps checking for up to 45 days. If PayPal's answer gets lost during checkout, the customer sees “We couldn't confirm your payment with PayPal yet. Please don't pay again.” and the hourly check settles the order. After 3 days without an answer it stops checking, adds an order note and alerts the admin to look the payment up in PayPal.

Related

Still stuck? We're quick to respond.

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