← Help home

Common symptoms and checks

Last reviewed: 2026-04-27 · Owner: Product & Engineering

Goal

Narrow down integration issues quickly using safe, non-secret evidence.

Prerequisites

  • Correlation ids or HTTP statuses from failing calls.
  • Synthetic tenant/partner samples when describing reproductions.

Steps

  1. 403 / scope: Re-read Tenants, roles, and scope; fix headers or roles.
  2. Partner missing: Validate registry entries per Partner registry.
  3. Federation loops: Check callbacks and issuers with IdP operators per Federation boundary.
  4. Finance sync stuck: Review Finance Sync fields and adapter logs.

Verify

  • Each retry changes a single variable (tenant id, partner key, time window) to isolate root cause.
  • No secrets pasted into tickets or help feedback.

If it fails

Open a support incident with timestamps, correlation ids, and roles involved—omit JWTs and client secrets.

Further reading

  • Operations runbooks under 08_Docs_Playbooks.
  • Help home for the full topic list.