Skip to main content

API-workflow for individ-onboarding

Bruk dette kartet for å koble individ-KYC-policy til den gjeldende genererte API-referansen. Følg gjeldende ressurs i hvert trinn i stedet for å implementere policyvendte merkelapper som en API-tilstandsmaskin.

Workflow-kart

1. Opprett individkunden

Opprett kunden med POST /v3/customers. Lagre den returnerte kunde-ID-en og les den gjeldende ressursen med GET /v3/customers/{customerId}.

2. Oppdag og be om en kvalifisert capability

Les GET /v3/customers/{customerId}/capabilities/supported. Velg en variant kun når dens gjeldende availability og eligibility tillater forespørselen, og bruk deretter POST /v3/customers/{customerId}/capabilities/{capabilityId}.

3. Les gjeldende capability og applications

Les GET /v3/customers/{customerId}/capabilities/{capabilityId} og GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications. Følg gjeldende åpne oppgave-ID-er i stedet for å anta klarhet fra en tidligere respons.

4. Hent gjeldende oppgavedetalj

List kundeoppgaver med GET /v3/customers/{customerId}/tasks. Hent den autoriserte handlingsflaten med GET /v3/customers/{customerId}/tasks/{taskId}. Oppgavedetaljer kan eksponere URL-er for førsteparts hosted sesjoner og de gjeldende handlingsklare kravene. Bruk gjeldende revisjon og status.

5. Fullfør hosted sesjoner eller send inn oppgavesvar

Når oppgavedetalj gir en hosted sesjon, returner kun nødvendige sesjonsdata til klienten din og hold API-nøkkelen i backend. Når oppgaven krever svar, opprett ett komplett uforanderlig forsøk med POST /v3/customers/{customerId}/tasks/{taskId}/submissions. Les én gjeldende innsending og dens offentlige utfall med GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}.

6. Last opp dokumenter kun når det er forespurt

Last opp dokumenter kun når den gjeldende oppgaven ber om dem. Bruk POST /v3/customers/{customerId}/documents, og plasser så den returnerte dokument-ID-en i det aktuelle dokumentsvaret.

7. Hent gjeldende ressurser på nytt

Hent gjeldende kunde, capability, applications og oppgave på nytt etter hver hendelse eller handling. Bruk deres siste tilstander, årsaker, krav og åpne oppgave-ID-er for å velge neste trinn.

Kart over genererte operasjoner

Policy- og implementeringsveiledning

Simplified, Standard og Enhanced KYC er policy-nivåer. De erstatter ikke gjeldende tilstander for capability, application, oppgave, innsending, krav eller hosted sesjon. For implementeringsdetaljer, følg individ-onboarding-guiden, Capabilities og oppgaver og Integrasjonsdokumenter-veiledningen.