Skip to main content

API-Workflow für Einzelpersonen-Onboarding

Nutzen Sie diese Karte, um die individuelle KYC-Richtlinie mit der aktuell generierten API-Referenz zu verbinden. Folgen Sie bei jedem Schritt der aktuellen Ressource, statt richtlinienorientierte Labels als API-Zustandsmaschine zu implementieren.

Workflow-Karte

1. Einzelkunden anlegen

Legen Sie den Kunden mit POST /v3/customers an. Speichern Sie die zurückgegebene Kunden-ID und lesen Sie die aktuelle Ressource mit GET /v3/customers/{customerId}.

2. Eine berechtigte Fähigkeit entdecken und anfordern

Lesen Sie GET /v3/customers/{customerId}/capabilities/supported. Wählen Sie eine Variante nur, wenn ihre aktuelle Verfügbarkeit und Berechtigung die Anfrage zulassen, und verwenden Sie dann POST /v3/customers/{customerId}/capabilities/{capabilityId}.

3. Aktuelle Fähigkeit und Anwendungen lesen

Lesen Sie GET /v3/customers/{customerId}/capabilities/{capabilityId} und GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications. Folgen Sie den aktuellen offenen Aufgaben-IDs, statt Bereitschaft aus einer früheren Antwort abzuleiten.

4. Aktuelles Aufgabendetail abrufen

Listen Sie Kundenaufgaben mit GET /v3/customers/{customerId}/tasks auf. Rufen Sie die autorisierte Aktionsoberfläche mit GET /v3/customers/{customerId}/tasks/{taskId} ab. Aufgabendetails können URLs gehosteter Erstpartei-Sessions und die aktuell handlungsfähigen Anforderungen offenlegen. Verwenden Sie ihre aktuelle Revision und den Status.

5. Gehostete Sessions abschließen oder Aufgabenantworten einreichen

Wenn das Aufgabendetail eine gehostete Session bereitstellt, geben Sie nur die erforderlichen Session-Daten an Ihren Client zurück und behalten Sie den API-Schlüssel in Ihrem Backend. Wenn die Aufgabe Antworten erfordert, erstellen Sie einen vollständigen unveränderlichen Versuch mit POST /v3/customers/{customerId}/tasks/{taskId}/submissions. Lesen Sie eine aktuelle Einreichung und ihr öffentliches Ergebnis mit GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}.

6. Dokumente nur bei Anforderung hochladen

Laden Sie Dokumente nur hoch, wenn die aktuelle Aufgabe dies verlangt. Verwenden Sie POST /v3/customers/{customerId}/documents und platzieren Sie dann die zurückgegebene Dokument-ID in der zutreffenden Dokumentantwort.

7. Aktuelle Ressourcen erneut abrufen

Rufen Sie den aktuellen Kunden, die Fähigkeit, die Anwendungen und die Aufgabe nach jedem Ereignis oder jeder Aktion erneut ab. Verwenden Sie ihre neuesten Zustände, Gründe, Anforderungen und offenen Aufgaben-IDs, um den nächsten Schritt auszuwählen.

Karte generierter Operationen

Richtlinien- und Umsetzungshinweise

Simplified, Standard und Enhanced KYC sind Richtlinienstufen. Sie ersetzen nicht aktuelle Fähigkeits-, Anwendungs-, Aufgaben-, Einreichungs-, Anforderungs- oder Gehostete-Session-Zustände. Für Umsetzungsdetails folgen Sie dem Leitfaden für Onboarding von Einzelpersonen, Fähigkeiten und Aufgaben und dem Integrations-Dokumenten-Leitfaden.