Integration checklist
- Live key stored in a secrets manager and never exposed client-side.
- Every
POSTsends a uniqueIdempotency-Key, and retries reuse it. - Retries on
429,500and503use exponential backoff and honourRetry-After. - Timeouts are set (we suggest 5 seconds for single screenings) with a safe fallback, for example holding the onboarding for manual review.
- Non-Latin names (
422 unsupported_script) are transliterated or routed to manual review. - A
hit: trueresult pauses the flow and creates a case for an analyst. -
external_idis sent, so whitelisting and future monitoring work. - Screening
id,list_versions andmodel_versionare stored with your customer record for audit. - Webhook signatures are verified, and events are deduplicated by
id. - Automated tests cover the sandbox test names, including error triggers.
- Your threshold was reviewed with your compliance team.