When Stuck+ activates
Stuck+ is your fallback path whenever Verify returnsvalidNumber: false or the SDK can’t produce a proof (for example sdk_no_he_result on Wi‑Fi). Instead of dropping back to an SMS OTP, you surface a Stuck+ unlock and Authmatech still works to confirm the customer’s identity.
What you can do with the API
All Stuck+ endpoints live under/v1/api/me/stuck-plus/** and use the standard X-API-KEY + X-CLIENT-ID headers.
| Action | Endpoint |
|---|---|
| Overview of stuck sessions | GET /v1/api/me/stuck-plus/overview |
| List stuck sessions | GET /v1/api/me/stuck-plus/sessions |
| Inspect a session’s journey | GET /v1/api/me/stuck-plus/sessions/{sessionId}/journey |
| Reveal the confirmed identity (consumes credits) | POST /v1/api/me/stuck-plus/sessions/{sessionId}/reveal |
| Reset a session | POST /v1/api/me/stuck-plus/sessions/{sessionId}/reset |
| Recover historical sessions | POST /v1/api/me/stuck-plus/backfill |
| Audit who revealed what | GET /v1/api/me/stuck-plus/reveals |
A typical recovery flow
Detect the stall
Background verification fails or the SDK can’t enrich. Show the customer a Stuck+ unlock instead of an OTP.
List stuck sessions
Your operations tooling polls
GET /v1/api/me/stuck-plus/sessions to see customers who became stuck and their journey context.Reveal when justified
For a session worth recovering, call
reveal to obtain the confirmed identity and reconnect with the customer — within your own policy and consent rules.Configuration
Stuck+ behavior (such as retention and reveal policy) is configured per account. Admins manage it via the dashboard; the effective configuration is also reachable through the dashboard Stuck+ config endpoints. Talk to sales@authmatech.com to enable Stuck+ or adjust limits.Stuck+ never downgrades a customer to an SMS OTP. When a customer submits their number through the unlock, Authmatech still confirms their identity over the network.