Skip to main content

API workflow onboardingu fyzických osob

Použijte tuto mapu k propojení politiky KYC pro fyzické osoby s aktuální generovanou API referencí. Postupujte podle aktuálního zdroje v každém kroku místo implementování štítků z pohledu politiky jako stavového automatu API.

Mapa workflow

1. Vytvořte fyzickou osobu jako zákazníka

Vytvořte zákazníka pomocí POST /v3/customers. Uložte vrácené id zákazníka a přečtěte aktuální zdroj pomocí GET /v3/customers/{customerId}.

2. Objevte a požádejte o vhodnou capability

Přečtěte GET /v3/customers/{customerId}/capabilities/supported. Vyberte variantu pouze tehdy, když aktuální dostupnost a způsobilost umožňují požadavek, poté použijte POST /v3/customers/{customerId}/capabilities/{capabilityId}.

3. Přečtěte aktuální capability a aplikace

Přečtěte GET /v3/customers/{customerId}/capabilities/{capabilityId} a GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications. Postupujte podle aktuálních otevřených ID úkolů místo předpokládání připravenosti z dřívější odpovědi.

4. Načtěte detail aktuálního úkolu

Zjistěte úkoly zákazníka pomocí GET /v3/customers/{customerId}/tasks. Načtěte autorizovanou akční plochu pomocí GET /v3/customers/{customerId}/tasks/{taskId}. Detail úkolu může vystavit URL hostovaných relací první strany a aktuální akční požadavky. Používejte jeho aktuální revizi a stav.

5. Dokončete hostované relace nebo odešlete odpovědi úkolu

Když detail úkolu poskytne hostovanou relaci, vraťte klientovi pouze potřebná data relace a API klíč držte v backendu. Když úkol vyžaduje odpovědi, vytvořte jeden kompletní neměnitelný pokus pomocí POST /v3/customers/{customerId}/tasks/{taskId}/submissions. Přečtěte jedno aktuální odeslání a jeho veřejný výsledek pomocí GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}.

6. Nahrajte dokumenty pouze, když jsou vyžádány

Nahrávejte dokumenty pouze tehdy, když je aktuální úkol vyžaduje. Použijte POST /v3/customers/{customerId}/documents a poté umístěte vrácené ID dokumentu do odpovídající odpovědi na dokument.

7. Znovu načtěte aktuální zdroje

Po každé události nebo akci znovu načtěte aktuálního zákazníka, capability, aplikace a úkol. Použijte jejich nejnovější stavy, důvody, požadavky a otevřené ID úkolů k výběru dalšího kroku.

Mapa generovaných operací

Pokyny k politice a implementaci

Zjednodušené, Standardní a Zvýšené KYC jsou politické úrovně. Nenahrazují aktuální stavy capability, aplikace, úkolu, odeslání, požadavků ani hostovaných relací. Pro implementační detaily postupujte podle průvodce onboardingem fyzických osob, Capabilities a úkoly a průvodce integračními dokumenty.