Signi ověření — jak funguje

Změněno dne Po, 17 Srpen v 3:22 ODPOLEDNE

ℹ️ 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.

Signi ověření je ověření totožnosti protistrany předtím, než se dostane k podpisu — vzdálená identifikace pro případy, kdy potřebujete vědět, kdo skutečně podepisuje (AML povinnosti, smlouvy na dálku, HR). Protistrana projde ověřením podle pravidel, která zvolíte, navrhovatel výsledek zkontroluje a teprve pak může protistrana podepsat.

Signi ověření musí být pro váš workspace zapnuté — bez toho API vrací chybu 406. Domluvte se se svým kontaktem v Signi.

Skupiny ověření

Co přesně má ověřovaný doložit, určuje skupina ověření — sada kontrol (komponent), např. bankovní identita, doklad totožnosti, kontrola živosti (selfie), SMS, dotazník, mikroplatba nebo platební karta. Workspace má k dispozici systémové skupiny Signi a případně vlastní.

curl -H "x-api-key: VAS_API_KLIC" https://api.signi.com/api/v2/verifications-groups

[
    {
        "uuid": "11111111-2222-3333-4444-555555555555",
        "name": "AML ověření",
        "isSystem": true,
        "isAml": true,
        "validityPeriodDays": 365,
        "components": ["bankId", "document", "liveliness"]
    }
]

isAml — skupina je nastavena jako ověření na úrovni AML a Signi přistupuje k datům podle toho v rámci politiky retence dat.
validityPeriodDays — jak dlouho schválené ověření platí; po tu dobu ho jde znovu využít bez nového běhu.
Ověřovanému můžete nabídnout 1–2 skupiny — vybere si, kterou cestou se ověří (třeba bankovní identita, nebo doklad + selfie).

Dvě cesty, jak ověření založit

U dokumentu — nejběžnější: na rozpracovaný dokument navážete ověření protistrany. Protistrana se k podpisu nedostane, dokud není ověřená. Když už má platné ověření, použije se automaticky znovu.
U kontaktu — ověření nezávislé na dokumentu: kontakt z adresáře ověříte „do zásoby" a platné ověření se pak uplatní u budoucích dokumentů.

Stavy ověření

Stav	Význam
`pending`	Založeno, ověřovaný ještě nezačal.
`in_progress`	Ověřovaný prochází kontrolami.
`awaiting_review`	Hotovo, čeká na kontrolu navrhovatele.
`approved`	Schváleno — platí do `expiresAt` (podle `validityPeriodDays` skupiny).
`rejected`	Zamítl navrhovatel — konečný stav; volitelně vzniká nový pokus.
`declined`	Odmítl sám ověřovaný (s uvedeným důvodem).
`expired`	Vypršela platnost.
`abandoned`	Ověřovaný to nedokončil, ověření zůstalo rozpracované.

O změnách stavu se dozvíte webhooky ověření nebo dotazem na detail.

Kam dál

Ověření u dokumentu — hlavní scénář: draft → navázání ověření → odeslání
Založení ověření kontaktu
Signi ověření — přehled