Help Center › Orders & Consultations › The Webhooks page and unmatched webhooks

The Webhooks page and unmatched webhooks

Updated November 17, 2026 · Orders & Consultations

Qualiphy sends your site a status update, called a webhook, whenever a consultation result, prescription or tracking number comes in, and Quidget uses it to update the matching order. From version 1.2.5 there’s nothing to set up: the plugin registers your site’s webhook address with Qualiphy itself, and the Webhooks page shows whether that worked and what has arrived.

Automatic registration

  • Each API key is registered separately: your main key and, with Location Based API Keys, every verified clinic key.
  • Registration runs whenever a key is verified (the setup wizard, re-verifying on the API Key card, clinic key checks and the connection test), and a daily check catches a changed key or site address. Existing sites register shortly after updating.
  • If Qualiphy refuses a consultation because the address isn’t registered, the plugin registers it on the spot and sends the invite once more.

You don’t need to add a webhook address in your Qualiphy account.

Verified and unverified webhooks

Each webhook is checked to confirm it came from Qualiphy. Only verified webhooks can refund a Not approved order automatically. Unverified webhooks still update the order (status, emails and subscriptions), but the refund is left to you, with the note “Refund not issued automatically: this webhook couldn’t be verified as coming from Qualiphy. Refund manually if appropriate.” When you see it, refund by hand if appropriate, then check the Webhooks page shows Registered for the key the order used.

Opening the Webhooks page

  1. Go to Qualiphy → Settings.
  2. In General Settings, turn on Advanced Settings.
  3. On the Webhooks row, click View webhooks. The row shows an “N unmatched” badge when webhooks are waiting.

The page isn’t in the Qualiphy menu; the “Qualiphy webhooks need attention” notification and the System Log also link to it. Only administrators can open it. It has three cards.

Webhook registration

One row per API key (“Main account”, “Clinic: [name]”) showing Registered, Not registered with Qualiphy’s reason, or Not registered yet, plus the last 4 characters of its signing key. Buttons: Register now, Re-register (new signing key) and Check all.

Unmatched webhooks

A webhook that matches no order is kept here for 30 days, and you get a “Qualiphy webhooks need attention” notification. This usually means the order’s invite failed or the consultation was sent outside that order. For each row:

  • Pick the order (orders with the patient’s email are suggested first) and press Process. The order then updates, and later updates for that consultation match on their own.
  • Leave it on “Match automatically” to retry, or press Process all to retry every row.
  • Press Dismiss to delete it.

Rows marked “Not verified as sent by Qualiphy. Processing it will not refund automatically.” still update the order when processed. Assigning an order doesn’t make them verified.

Recent webhooks

The last 100 outcomes, such as Processed, Processed (repeat of a decision already applied), No matching order, Dismissed, or Rejected with a reason like “too many requests” or “invalid request body”. Only order and consultation IDs are kept, no patient details. Repeats are normal: Qualiphy sends each result more than once and Quidget applies it once.

When registration shows a problem

Fix the cause shown on the row, then press Register now.

“Qualiphy didn’t accept this API key.”The key was rejected, for example deleted or replaced in your Qualiphy account. For the main account this shows only here, with no email or notification: enter a current key under Qualiphy → Settings → API Key (turn on Advanced Settings to see that card). For a clinic row, the clinic enters its key again in My Clinic, or you can on the location’s edit page.
“Qualiphy only accepts a public https:// address.”The site must use https:// and be reachable from the internet. Local and private test sites can’t register.
“This Qualiphy clinic already has the maximum of 10 webhook addresses.”Ask Qualiphy support to remove an old one, then register again.
“Qualiphy is busy right now.”It’s retried automatically. Press Register now later if it persists.
Not registered yet: “The webhook address changed since it was registered”Your site address changed. Wait for the daily check or press Register now.

Updates not reaching your site

If a consultation happened but nothing appears under Recent webhooks, the update never arrived. Check security and firewall plugins, firewall rules at your host or CDN, maintenance mode, password protection and caching rules: anything that blocks inbound requests from Qualiphy to your site’s WordPress REST API stops status updates. See Known plugin conflicts. What each update does to an order is in Consultation results.

Still stuck? We're quick to respond.

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