Partner-API verification B — Shopify, helpdesk, social, reviews, subscriptions, new apps

Summary

# Claim Verdict Roadmap change needed
1 Shopify webhook retries, timeout, subscription deletion CONFIRMED No (add the numbers)
2 HMAC on raw body, 401 on bad HMAC, duplicate guidance PARTLY Yes: dedupe key is X-Shopify-Webhook-Id, Joy uses X-Shopify-Event-Id
3 Cloud Tasks task size CONFIRMED (1 MiB), with a Google doc conflict Small
4 GraphQL throttling and bulk tag updates PARTLY Yes: THROTTLED arrives as HTTP 200; existing bulk tag path uses customerUpdate, not tagsAdd
5 Flow action status handling PARTLY Yes: retry window is 36 h; timeouts and 429 are also resent
6 Gorgias invalid_client, token lifetimes, rate limits PARTLY (meaning of invalid_client UNVERIFIABLE in Gorgias docs) Yes: soften "points at Joy's client"
7 Instagram token lifetime, refresh rules, error codes, signature CONFIRMED Yes: 2.7 lacks a proactive refresh
8 Review-app webhook signing PARTLY Yes: Fera can be verified today (JWT); Yotpo cannot
9 Recharge webhook verification and scopes PARTLY Yes: it is not a keyed HMAC, and it needs a secret Joy does not store
10 Loop signature header, topic name, listing PARTLY Yes: topic is return, trigger is return.closed; no "customer chose exchange" field
11 Tapcart blocks, customer session, partner program PARTLY (session contents UNVERIFIABLE) No (the spike is the right step)
12 Okendo Flow trigger, loyalty connector CONFIRMED Small: trigger fires on submit, before moderation
13 App Store / BFS rules touched by non-2xx or the health banner PARTLY Yes: compliance webhooks must answer 401; banner count rule
14 Cloud Tasks dedupe window, at-least-once, retries, rate limits CONFIRMED Yes: a 429 returned to Cloud Tasks throttles the whole queue

Three findings change a fix rather than its wording: claim 2 (dedupe key), claim 8 (Fera), claim 9 (Recharge secret). They are repeated in the last section.


Claim 1 — Shopify webhooks: retries, timeout, subscription deletion

Verdict: CONFIRMED.

Docs — https://shopify.dev/docs/apps/build/webhooks/subscribe/https

Joy today (Local):

Roadmap check: item 2.20 ("Shopify deletes API-created subscriptions after repeated failures", shadow week first, daily subscription check) matches the docs.

Suggested addition to 2.20, not a correction: "Shopify counts any non-2xx, including 3xx, and any answer slower than 5 seconds as a failure, retries 8 times over 4 hours, and deletes an Admin-API subscription after 8 consecutive failures. The shadow mode must therefore also count answers slower than 5 seconds, because they already count toward deletion today."

Claim 2 — HMAC on raw body, answer to a bad HMAC, duplicates

Verdict: PARTLY. The HMAC and 401 parts are confirmed. The dedupe key is not the one Joy uses.

Docs — https://shopify.dev/docs/apps/build/webhooks/subscribe/https

Docs — https://shopify.dev/docs/apps/build/webhooks/ignore-duplicates

Joy today (Local):

What this means (Inference): Shopify says X-Shopify-Event-Id is shared by every delivery that came from one merchant action. Joy treats the second delivery with the same event id as a duplicate and drops it, even when it is a different subscription. Whether one action produces two orders/* deliveries with one event id was not observed; it must be measured before 2.19 fixes the dedupe record.

Corrected wording for 2.19: "Key the dedupe record on X-Shopify-Webhook-Id (the delivery), as Shopify documents; keep X-Shopify-Event-Id only for correlation. Before the change, count in the shadow mode how many deliveries are dropped today because they share an event id with a different webhook id or topic."

Corrected wording for 2.20: "A bad HMAC gets 401. Verify against the raw body only and compare timing-safe; drop the second accepted form (HMAC of the re-serialised JSON) after the shadow week shows nothing depends on it."

Claim 3 — Cloud Tasks task size

Verdict: CONFIRMED at 1 MiB, with a conflict between two Google pages.

Docs — https://docs.cloud.google.com/tasks/docs/quotas : maximum task size "1 MiB", described as "The maximum size of a task that can be added to a queue."

Docs — https://docs.cloud.google.com/tasks/docs/reference/rest/v2/projects.locations.queues.tasks/create : "The maximum task size is 100KB."

The two pages disagree. The quotas page is the one Google maintains as the limit table, and the 303 production failures named "Task size too large" on large order payloads are consistent with either number. Treat 1 MiB as the limit and 100 KB as stale reference text, and do not design to the edge of either.

Joy today (Local): the whole ctx.state (shop document plus order payload) is the task body (F/middleware/webhook/enqueueWebhookToCloudTasks.js:34-43).

Roadmap check: 2.19 ("enqueue a small reference task", "measure the envelope size on staging") and 3.4 ("one size limit applies at enqueue") are consistent. Suggested addition to 3.4: "Set the enqueue size limit well under 100 KB, because Google's pages state both 1 MiB and 100 KB."

Claim 4 — Admin GraphQL throttling, bulk operations for tags

Verdict: PARTLY. Limits and bulk feasibility are confirmed. Two details the roadmap does not state would break the first slice of 2.18.

Docs — https://shopify.dev/docs/api/usage/response-codes

Docs — https://shopify.dev/docs/apps/build/apis/graphql-admin/rate-limits

Docs — https://shopify.dev/docs/api/usage/limits : "The recommended backoff time is one second." "Input arguments that accept an array have a maximum size of 250, on every Shopify API."

Docs — https://shopify.dev/docs/api/usage/bulk-operations/imports

Joy today (Local):

What this means:

Corrected wording for 2.18: "Errors stay typed and retryable: detect a throttle from errors[].extensions.code == THROTTLED on an HTTP 200 answer, not from the status. The per-shop queue admits work against extensions.cost.throttleStatus (one bucket per app and shop, restore rate 100 to 2,000 points a second by plan) and waits at least one second after a throttle. Mass tag runs go through a bulk mutation built on tagsAdd / tagsRemove; the existing bulk tag code uses customerUpdate with the full tag array and must not be reused as-is, because it overwrites tags changed in between. On API versions before 2026-01 only one bulk mutation runs per shop at a time, so the run must queue behind Joy's own metafield and tier bulk jobs."

Claim 5 — Shopify Flow actions

Verdict: PARTLY. The roadmap's rule (use a 4xx, not a 5xx) is right. The retry window and two more resend cases are missing.

Docs — https://shopify.dev/docs/apps/build/flow/actions/endpoints

Joy today (Local):

What this means (Inference): an action that takes longer than 10 seconds, or that answers 429, is resent by Flow. Joy's middleware has already stored the action_run_id, so the resend gets "duplicated" with HTTP 200 and Flow records a success for work that may not have finished. This is the same trap 2.13 names for 5xx, on two more paths.

Corrected wording for 2.13: "Return a 4xx (not 429) with a message key when an action fails; Flow shows the raw response to the merchant and does not resend. Do not use 5xx, 429 or 202, and do not exceed 10 seconds: Flow resends those for up to 36 hours, and the middleware would answer the resend as a duplicate with 200. Move the action_run_id marker to after the handler completes (the acceptance contract of 2.19), so a resend after a timeout is processed instead of acknowledged. A bad HMAC gets 401."

Item 4.2's "402 with an upgrade message" is consistent: 402 is an "other 4XX", so it is not resent and its message is shown.

Claim 6 — Gorgias

Verdict: PARTLY. Token lifetimes and rate limits are confirmed. The meaning of invalid_client is UNVERIFIABLE in Gorgias's docs.

Docs — https://developers.gorgias.com/docs/set-up-oauth2-app-store

Docs — https://developers.gorgias.com/docs/oauth2-authentication-for-creating-apps-with-gorgias : "In case the application is deactivated on the helpdesk, in order to obtain the access token again, the entire process for obtaining an access token needs to be repeated." The refresh response example has no refresh_token field.

Docs — https://developers.gorgias.com/reference/limitations : "OAuth2 apps can make 80 requests in a 20 second window"; "API key integrations can make 40 requests in a 20 second window"; "Enterprise accounts folow the same request limits, but have a smaller 10-second window". Headers: Retry-after and X-Gorgias-Account-Api-Call-Limit.

invalid_client: neither OAuth page nor https://developers.gorgias.com/reference/errors lists OAuth error codes. In the OAuth 2.0 standard (RFC 6749 section 5.2) it means client authentication failed. Gorgias does not say when it returns it.

Joy today (Local):

What this means (Inference): the same client id and secret are sent for every account, and only 8 of 58 connected accounts fail. A dead Joy client would fail all of them. The token endpoint is per subdomain, so an account-level cause (app uninstalled or deactivated on that helpdesk, subdomain renamed, account closed) fits the data at least as well. The header name X-Gorgias-Account-Api-Call-Limit suggests the limit is counted per account, which a per-instance limiter cannot respect.

Corrected wording for 2.6 "Why": "invalid_client on 8 accounts since 2026-11-05 01:46 UTC, none before. Gorgias does not document this error; in OAuth 2.0 it means client authentication failed. Because the other connected accounts refresh with the same client, test account-level causes first (app uninstalled or deactivated on that helpdesk, subdomain changed) by refreshing one healthy account and comparing." Decision 3 should carry the same test. Item 1.8 can then tell the 8 shops to reinstall the app, which the docs say requires the whole authorization flow again.

Claim 7 — Instagram / Meta

Verdict: CONFIRMED. One gap in the fix.

Docs — https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/business-login

Docs — https://developers.facebook.com/docs/graph-api/guides/error-handling (page was served in Vietnamese; meanings given in English): code 190 = access token expired, get a new token. Subcode 460 = password changed, the user must log in to the app again. Subcode 463 = expired; the login status or token has expired, been revoked or is invalid. Subcode 467 = invalid access token. Codes 4 and 17 = too many calls, temporary, wait and retry.

Docs — https://developers.facebook.com/docs/graph-api/webhooks/getting-started

Joy today (Local):

What this means (Docs + Local): Joy's refresh window is the last 24 hours of a 60-day token, and only if the integration is used inside that window. A shop with no Instagram activity that day passes the expiry, and Meta then refuses the refresh for good. Marking auth_broken (2.7) reports this; it does not prevent it.

Suggested addition to 2.7: "Add a scheduled refresh for tokens that are more than 24 hours old and have less than about 30 days left; an expired token cannot be refreshed and needs a new login. Treat error 190 (subcodes 460, 463, 467) as auth_broken, and codes 4 and 17 as transient."

Not confirmed: which app secret signs webhooks for Instagram Login apps. The Instagram webhooks page only says "Your endpoint must validate notification signatures."

Claim 8 — Review-app webhook signing

Verdict: PARTLY. Judge.me and Klaviyo Reviews are confirmed. The roadmap's plan for Fera is wrong, and for Yotpo it is the only option.

App What the partner documents Source Joy today (Local)
Judge.me Header JUDGEME-HMAC-SHA256; examples use a hex HMAC-SHA256 of the raw body and answer 401. "If the webhook was created through an OAuth app, use the OAuth app's secret key"; if created with the store's Private API token, "use that same Private API token as the secret." https://judge.me/help/en/articles/8299679-verifying-webhooks-from-judge-me No signature check (F/middleware/webhook/verifyHookReviewApp.js:17-57). Webhooks are registered with the OAuth access token (F/services/reviews/judge.js:77-105)
Klaviyo Reviews Headers Klaviyo-Signature, Klaviyo-Timestamp, Klaviyo-Webhook-Id; HMAC-SHA256 "using the request body, your secret_key, and the timestamp". Expects 200, 201 or 202 "within 5 seconds"; a webhook in error for over 48 hours is disabled. "only Advanced KDP customers and Klaviyo app partners can access and manage webhooks with our Webhooks API." https://developers.klaviyo.com/en/docs/working_with_system_webhooks Body then timestamp, hex, matches the docs (F/middleware/webhook/verifyKlaviyoWebhook.js:16-29). Skipped when no secret is found (:108-125)
Fera "When Fera POSTs to a webhook URL it will include a JWT token as a the jwt URL parameter." The JWT "uses Standard HS256 (HMAC SHA256) encryption", signed with the store's Secret Key (or the Client Secret for partner apps), with claims webhook_id, event_name, store_domain, store_id, exp; it expires after one hour https://developers.fera.ai/reference/webhooks and https://developers.fera.ai/docs/webhook-structure No check. Joy already stores the store's Fera secret key and uses it for the connect test (F/services/reviews/fera.js:15-17)
Yotpo Headers X-Yotpo-Webhooks-Event-Type, X-Yotpo-Webhooks-Tenant-Type, X-Yotpo-Webhooks-Tenant-Id, WebhookMessageId, WebhookMessageIdPerTarget ("Use it to ignore duplicates."). No signature or secret is described. "If Yotpo doesn't get a 200", it retries at least 10 times with exponential backoff. Target URLs must be HTTPS and at most 2048 characters https://docs.yotpo.com/from/developer/reference/yotpo-events and https://docs.yotpo.com/docs/about-webhook-events No check; a processing error is answered 200 (F/middleware/webhook/verifyHookReviewApp.js:54-57)
Loox "add a validation key to verify that incoming webhooks are from Loox." Without a key, "webhooks are delivered unsigned." "Available on the Convert and Unlimited plans." The merchant sets the key in Loox admin, Settings > API Keys > Webhooks https://help.loox.io/support/solutions/articles/501000356871-loox-reviews-api-and-webhooks Header x-loox-signature, hex HMAC-SHA256, timing-safe, only when a key is stored (F/middleware/webhook/verifyHookLoox.js:15-25, :70-85)
Stamped Headers on every push: X-Secret-Key, X-Stamped-Webhook-Secret, X-Stamped-Store-Url, X-Shopify-Shop-ID, X-Stamped-Topic. "Enter a secret only if the application or service receiving your webhook requires one for validating incoming requests." No body HMAC is described https://stampedsupport.stamped.io/hc/en-us/articles/10152800778395-Webhooks No ingestion path (roadmap section 1)
Air Reviews Avada's own app; no public developer docs none Header X-Air-Reviews-Hmac-Sha256, HMAC-SHA256 (F/services/reviews/airReview.js:125-151)
Review Rocket No developer or webhook documentation found none No check

Verdict per part:

Corrected wording for 3.8: "… and Loox (full enforcement). Fera moves into this item: verify the jwt URL parameter (HS256, signed with the store's Fera secret key that Joy already stores), check exp and that store_domain matches the tenant. Only Yotpo and Review Rocket have no signing; they get a per-shop secret in the registered URL next quarter, and dedupe on Yotpo's WebhookMessageIdPerTarget." Change the two "URL tokens for Yotpo and Fera" lines (3.8 and the deferred list) to "URL tokens for Yotpo and Review Rocket".

Constraint for all review sources: Yotpo retries only when it "doesn't get a 200", and Joy answers 200 on a processing error, so the partner's retry is never used. The verifier contract's "accept durably before acknowledging" covers this.

Claim 9 — Recharge

Verdict: PARTLY. The header name is right. The algorithm is not a keyed HMAC, and the secret is one Joy does not have.

Docs — https://docs.getrecharge.com/docs/webhooks-overview

Docs — https://developer.rechargepayments.com/2021-11/webhooks_explained : "To use these webhooks your API Token must have read permissions for Orders enabled ( read_orders )."

Joy today (Local):

What this means:

Corrected wording for the Recharge part of 3.8: "Recharge: answer 200 within 5 seconds once the work is accepted (Recharge resends 20 times over 48 hours and then deletes the webhook). Verify X-Recharge-Hmac-Sha256 as the hex SHA-256 of the API Client Secret concatenated with the raw body; this is not a keyed HMAC. Collect the API Client Secret at connect (it is not the API token Joy stores), run dual-accept until each shop has supplied it, and take the tenant from the verified credential instead of the shopId query. The API token needs read_orders for order/created."

Claim 10 — Loop Returns

Verdict: PARTLY. Header and trigger are confirmed. The wording and the payload assumption need a fix. The listing process is UNVERIFIABLE.

Docs — https://docs.loopreturns.com/webhook-reference/validation

Docs — https://docs.loopreturns.com/webhook-reference/getting-started

Docs — https://docs.loopreturns.com/openapi/return-webhook.yaml

Joy today (Local): no Loop code exists. The planned route sits beside F/routes/apiHookV1.js:627.

What this means:

Corrected wording for 4.7: "An inbound Loop webhook on the return topic with the return.closed trigger only, verified with X-Loop-Signature (base64 HMAC-SHA256 of the raw body with the merchant's Loop webhook secret, which the merchant supplies at connect). Award points when state is closed and the payload has a non-empty exchanges array or a positive gift_card amount; identify the customer by customer (email) and provider_order_id. Answer within 10 seconds and dedupe by return id, because delivery is at-least-once."

Claim 11 — Tapcart

Verdict: PARTLY. The block and partner programme exist. What the customer session carries is UNVERIFIABLE from the docs, which is what the roadmap's spike is for.

Docs — https://dev.tapcart.com/docs/customer

Docs — https://www.tapcart.com/blog/tech-partner-program (dated September 25, 2023): "The Tech Partner Program is structured into three tiers: Elite Partner, Preferred Partner, and Core Partner." Developer tools named: "Custom Blocks, Web Bridge SDK, Insights Data Streaming, and more." Application through a form.

Not fetched first-hand: the plan requirement. A search result for https://docs.tapcart.com/docs reports that custom blocks and the CLI need an Enterprise plan; treat this as a lead to confirm in the spike.

Joy today (Local): the headless token grant is at F/controllers/headless/headlessAuthController.js:33-36 and F/services/headless/headlessAuthService.js:20-27 (as cited by the roadmap; not re-read for this report).

Roadmap check: 4.3 starts with "a spike to learn what Tapcart's customerSession carries". That is correct and necessary. Suggested addition: "The spike must answer one question first: is there anything in customerSession that Joy's server can verify with Shopify without a secret in the block? If not, the block cannot prove identity and the design changes. Also confirm the Tapcart plan that custom blocks require, since it bounds the number of shops the block can reach." The partner-programme page is three years old; the application route in 4.1 should be reconfirmed with Tapcart.

Claim 12 — Okendo

Verdict: CONFIRMED.

Docs — https://support.okendo.io/en/articles/4904493-how-to-use-the-okendo-review-created-shopify-flow-trigger

Docs — https://support.okendo.io/en/articles/8197562-award-yotpo-loyalty-points-for-okendo-reviews-using-shopify-flow : Okendo documents awarding a third-party loyalty app's points through this Flow trigger. No native connector for third-party loyalty apps was found; Okendo sells its own loyalty product.

Joy today (Local): the template to copy is extensions/flow-template-loox/shopify.extension.toml; the action is the reward-by-program handler ending at F/controllers/shopifyFlowController.js:1150-1160.

Roadmap check: 4.2 (a Flow template, no native connector) and the deferral of N-07 match the docs.

Suggested addition to 4.2 (Inference from the approve and reject links): "The Okendo trigger fires when the review is submitted, before moderation. The template should filter on rating and document that a rejected review has already been rewarded; no approved-review trigger was found."

Claim 13 — App Store and Built for Shopify

Verdict: PARTLY. No rule penalises a non-2xx answer to ordinary webhooks. Two rules do touch the roadmap.

Docs — https://shopify.dev/docs/apps/build/compliance/privacy-law-compliance

Docs — https://shopify.dev/docs/apps/launch/built-for-shopify/requirements

Joy today (Local):

What this means:

Suggested addition to 2.20: "The 401 for a bad HMAC is also an App Store requirement for the mandatory compliance webhooks; confirm that those topics use this verifier." Suggested addition to 3.10: "One Home banner at most, listing every app that needs action; it stays until fixed or dismissed, is red for errors and links to the fix. The health data must not add a blocking request to the Home page load (LCP 2.5 seconds)."

Claim 14 — Google Cloud Tasks

Verdict: CONFIRMED.

Docs — https://docs.cloud.google.com/tasks/docs/quotas

Docs — https://docs.cloud.google.com/tasks/docs/reference/rest/v2/projects.locations.queues.tasks/create

Docs — https://docs.cloud.google.com/tasks/docs/common-pitfalls : Cloud Tasks "errs on the side of guaranteed execution"; "As such, a non-zero number of duplicate executions do occur." Dispatches "ramp up slowly when the queue is newly created or idle".

Docs — https://docs.cloud.google.com/tasks/docs/reference/rest/v2/projects.locations.queues

Docs — https://docs.cloud.google.com/tasks/docs/configuring-queues : max_attempts is "the maximum number of attempts for a task, including the first. To allow unlimited retries, set this to -1."

Joy today (Local):

Roadmap check: section 3.3 (500 per second, 1,000 queues), decision 2 in 5.3 ("its reuse is blocked for up to 24 hours", "a task can run more than once") and risk 2 all match the docs.

One constraint the roadmap does not state (Docs): the worker must never pass a partner's 429 or 503 through as its own HTTP answer to Cloud Tasks. Cloud Tasks reads those two codes as a signal to slow the whole queue, which would stall every shop and app on the shared delivery queue because one partner throttled one shop. It would also consume an attempt.

Suggested addition to the delivery worker (5.2 and 3.4): "On a partner 429 the worker creates a new task with a new attempt id and a scheduleTime after Retry-After, records the deferral, and answers 2xx to Cloud Tasks. It never answers 429 or 503 itself, because Cloud Tasks throttles the whole queue on those codes. A deferral cannot be scheduled more than 30 days ahead, and a new queue ramps up slowly, so the first cut-over must not start with a backlog."


Partner constraints the roadmap ignores that would break a fix

Ordered by how much they change the work.

  1. Recharge verification needs a secret Joy does not hold, and it is not an HMAC (claim 9, breaks 3.8). X-Recharge-Hmac-Sha256 is SHA-256 of the API Client Secret concatenated with the body. Joy stores only the API token. Enforcement needs a new credential from each connected shop.
  2. Recharge deletes a webhook after 20 failed deliveries in 48 hours (claim 9). Joy's handler sets no status or body. If the default answer is not 2xx, Joy's Recharge webhooks are being deleted today. Check on staging before any other Recharge work.
  3. Shopify's dedupe key is X-Shopify-Webhook-Id; Joy dedupes on X-Shopify-Event-Id, per shop, across topics (claim 2, affects 2.19 and 2.20). Deliveries that share an event id may be dropped as duplicates today. Measure before changing the dedupe record.
  4. Fera signs its webhooks (claim 8, changes 3.8 and the deferred list). A JWT in the jwt URL parameter, HS256, signed with the store secret key Joy already stores. No URL token and no merchant action are needed.
  5. A 429 or 503 answered to Cloud Tasks throttles the whole queue (claim 14, affects 3.4). Deferral must be a new task plus a 2xx answer.
  6. A GraphQL throttle is HTTP 200 with errors[].extensions.code = THROTTLED (claim 4, affects 2.18). Classification by status code misses it.
  7. The existing bulk tag path replaces tags (claim 4, affects 2.18). It uses customerUpdate with the full array. Reusing it for mass tag runs can erase a merchant's concurrent tag edit; use tagsAdd / tagsRemove in the bulk mutation.
  8. Flow resends on timeout (10 seconds), 429 and 202 as well as 5xx, for up to 36 hours (claim 5, affects 2.13 and 4.2). Joy's Flow function timeout equals Flow's wait, and the action_run_id is stored before the handler runs, so a resend after a slow action is acknowledged as a duplicate.
  9. An expired Instagram token cannot be refreshed, and a token under 24 hours old cannot be refreshed either (claim 7, affects 2.7). Joy refreshes only on use in the last 24 hours. Without a scheduled refresh, auth_broken will keep being reached by idle shops.
  10. Mandatory compliance webhooks must answer 401 to a bad HMAC or the app is rejected in review (claim 13, raises the priority of 2.20).
  11. Built for Shopify rejects two banners close together (claim 13, affects 3.10). One banner for all broken apps.
  12. Judge.me signs with Joy's OAuth app secret, one secret for all shops (claim 8, affects 3.8). The signature does not identify the tenant.
  13. Klaviyo disables a webhook that stays in error for over 48 hours and expects an answer within 5 seconds; Yotpo retries at least 10 times only on a non-200; Loop makes six attempts, allows 10 seconds and never retries a 401 (claims 8 and 10). Each verifier's enforcement window (gate G-4) must be shorter than the partner's disable or give-up window, or a bad rollout loses the subscription and the events.
  14. Bulk operations: one bulk mutation per shop at a time before API version 2026-01, five from 2026-01; apps in the Dev Dashboard must enable bulk operations, and access lapses after 31 days without use (claim 4, affects 2.18 and 3.5). The Admin API version Joy pins was not found in this worktree.
  15. Gorgias limits are 80 requests per 20 seconds for OAuth apps (10-second window on enterprise accounts), reported per account; Joy limits at 35 per 20 seconds per instance (claim 6). With several instances the real rate is unbounded. The delivery worker's admission should use the account as the limit scope and honour Retry-after.
  16. Loop has no field for "customer chose exchange" (claim 10, affects 4.7). The rule must be derived from exchanges, gift_card and state, and the signing secret is per merchant.
  17. Google states the task size limit as both 1 MiB and 100 KB (claim 3). Size the reference task far below both.

Evidence gaps

Unresolved questions

  1. Do the mandatory compliance webhooks pass through verifyHook? The app configuration file is not in this worktree.
  2. Which Admin API version does production pin? It decides whether a mass tag bulk run can run beside Joy's other bulk jobs.
  3. For the 8 failing Gorgias accounts: does a healthy account still refresh with the same client today? One refresh on a healthy account answers decision 3.
  4. Will the 23 Recharge shops be asked for their API Client Secret, or does Recharge verification fall back to a per-shop secret in the registered URL?