Trust Center
Ověřujte své vlastní uživatele: doklady totožnosti, shodu obličeje a kontroly firem.
Tři metody dělají z kódu to, co okno Ověřit osobu: otevřít relaci, přečíst relaci a vypsat relace. Každá působí na Trust Center účtu, jehož klíč API použijete.
Otevřete relaci
Zavolejte verify_session_create. Pošlete level (1 až 4, výchozí 2) a případně vlastní external_ref (nejvýše 200 znaků). Odpověď obsahuje session_id, hosted_url, který pošlete člověku, a expires_at, tedy za 24 hodin.
Pošlete odkaz
Přesměrujte uživatele na hosted_url nebo mu jej pošlete.
Přečtěte si výsledek
Zavolejte verify_session_result s session_id. Vrátí status, váš external_ref, časy a result, jakmile je relace dokončena.
Co o relaci rozhoduje
- Režim. Relace je testovací, když služba běží v testovacím režimu, a živá, když běží v živém. Testovací relace jsou zdarma, nikdy se nepočítají a lze je dokončit z dashboardu. Živé odkazy zatím nelze dokončit.
- Úroveň. Úroveň nad tím, co váš tarif povoluje, se odmítne a řekne, který tarif ji nese. Požadavek se nikdy tiše nesníží.
- Nad limitem. Živá relace nad měsíční limit tarifu se na Free odmítne a na placeném tarifu se vytvoří a označí jako překročení.
Klíče se vytvářejí ve Vývojářích a jejich vytvoření vyžaduje vaši vlastní úroveň 2.
Webhooky
Od tarifu Starter výše zadejte v nastavení Trust Center adresu a po rozhodnutí o ověření se odešle podepsaný požadavek, takže se nemusíte dotazovat opakovaně. Každý nese hlavičku Xuda-Event a hlavičku Xuda-Signature složenou z časové značky a HMAC časové značky a těla, podepsaného tajemstvím zobrazeným jednou v nastavení. Doručení, které selže, se zkusí znovu, nejvýše pětkrát.