Requiring a clinic at checkout and clinic shipping states
Two settings on the Location Settings card (Qualiphy → Settings, above Branding) control checkout on a multi-clinic store, and both are on by default. Require a clinic before checkout makes sure every order has a clinic. Only ship to the clinic's state makes orders with a Qualiphy item that ships go to an address in the chosen clinic's state.
Require a clinic before checkout
When this is on and a customer reaches checkout without a clinic, the checkout form is replaced with "Choose your clinic to continue" and a Choose a clinic button. The clinic picker opens over the page, and choosing a clinic reloads checkout. This works on both the classic and the Block checkout. It never appears on the Pay for order or Order received pages, or while the cart is empty.
If a checkout the plugin can't replace (for example, one built with a page builder) still tries to place an order without a clinic, the order is refused with "Please choose a clinic before placing your order."
The setting takes effect once the store has at least one active clinic.
When no clinic can take orders
With the Locations: Qualiphy API add-on on, customers can only choose clinics with a verified Qualiphy API key. If you have active clinics but none has a verified key, checkout is paused:
- Customers see "Checkout is unavailable right now" with "No clinic is available to handle orders right now, so checkout is paused. Please contact us." Adding to the cart is refused with the same explanation.
- Every Qualiphy admin page shows a red "Customers can't check out." banner. It explains that no clinic has a verified Qualiphy API key and links to Go to Locations and Go to settings.
To reopen checkout, verify at least one clinic's API key, or turn Require a clinic before checkout off to allow orders without a clinic.
Turning it off
With the setting off, orders without a clinic go through, but they aren't credited to any clinic. The order gets the note "No clinic was selected at checkout — order is unattributed.", no clinic gets a sale email, and the order doesn't appear in any clinic's sales. The plugin can't add a clinic to the order afterwards. With Locations: Qualiphy API on, these orders use your site's main Qualiphy API key.
Turning it off doesn't remove the clinic step from the cart: while at least one clinic can be chosen, customers still pick one before they can add products to the cart.
Only ship to the clinic's state
The setting's description reads: "For orders with Qualiphy products that ship, the shipping address must be in the selected clinic's state, and shipping is limited to the United States. The billing address can be anywhere."
It applies only when all of these are true:
- The cart has a Qualiphy item that ships: an Rx product, or a product bundle that contains one. Carts with only virtual consultations, or only your own store products, aren't affected.
- A clinic is selected, and its state is a valid two-letter US state.
- Your store ships to the United States.
- Test mode is off.
When it applies:
- The shipping country list shows only the United States.
- On the classic checkout, the shipping state list shows only the clinic's state.
- The Block checkout can't shorten its state list, so it shows a notice above the form: "Clinic ships to State only. Use a shipping address in State."
- On both checkouts, an order shipping to another state is refused with "Clinic can only ship to State. Please use a shipping address in State."
An order has one shipping address, so store products bought together with an Rx also ship to the clinic's state. Your service area still applies separately.
If a customer is stuck on this message, they can ship to an address in the clinic's state or choose a clinic in their own state. If your clinics ship anywhere, turn the setting off.
Related
Still stuck? We're quick to respond.
Email [email protected]. Available 7 days a week, 7 AM to 6 PM PT.