Schválení a zamítnutí ověření

ℹ️ Nová verze Signi ověření (včetně tohoto API) bude na produkci zveřejněna v průběhu září 2026. Do té doby volání nejsou dostupná a popis se může drobně změnit.

Když ověřovaný dokončí všechny kontroly, ověření přejde do stavu awaiting_review a čeká na kontrolu navrhovatele. Zkontrolovat a rozhodnout jde v aplikaci Signi, nebo přes API:

Schválení

curl -X POST -H "x-api-key: VAS_API_KLIC" \
  https://api.signi.com/api/v2/verifications/UUID_OVERENI/approve

Vrátí 204 bez těla. Ověření přejde do approved a platí po dobu podle skupiny ověření (expiresAt v detailu). Schvalovat jde jen ze stavu awaiting_review (jinak 409); opakované schválení už schváleného ověření ničemu nevadí.

Zamítnutí

curl -X POST -H "x-api-key: VAS_API_KLIC" -H "Content-Type: application/json" \
  https://api.signi.com/api/v2/verifications/UUID_OVERENI/reject \
  -d '{ "reason": "Doklad je nečitelný", "spawnRetry": true }'

{ "retryVerificationUuid": "aaaa1111-bbbb-2222-cccc-333344445555" }

• Zamítnutí je konečné a nevratné — ověření zůstane rejected navždy.
• reason — volitelný důvod; ověřovaný ho uvidí, uloží se k ověření.
• spawnRetry — true založí nový propojený pokus (kopii se stejnými nabídnutými skupinami), aby to ověřovaný mohl zkusit znovu; jeho UUID přijde v odpovědi. Výchozí false = zamítnout bez druhé šance.
• Zamítat jde ze stavů awaiting_review a in_progress.

Pozor: spawnRetry projde jen dokud jsou dokumenty navázané na ověření ještě „živé" (rozpracované, čekající na vyplnění nebo na podpis). U dokončeného či expirovaného dokumentu nový pokus založit nejde — volání vrátí 409 a nic se nezamítne.

Zamítnutí vs. odmítnutí

Nepleťte si dva podobné stavy: rejected = zamítl navrhovatel (tato kapitola), declined = sám ověřovaný odmítl ověřením projít — jeho důvod najdete v detailu jako declinedReason.

Kam dál

• Signi ověření — jak funguje — všechny stavy
• Webhooky ověření — hlášení o schválení či zamítnutí