API INTEGRATION GUIDE
Client Onboarding
Learn how to create a fully compliant client onboarding process using the rules for Client Classification API, Client Identification Natural Person API, Client Identification Non-Natural Person API and KYC API for more many countries.
This guide shows you how to:
-
Retrieve relevant Client Onboarding rules used to classify client types and request the proper identification formalities such as documentation, passport copies or signature requirements and KYC information.
-
Understand the results and integrate them into your onboarding application.
Flow of API sequence
In order to understand which formalities are necessary, you initially need to understand mandatory and optional roles in a legal entity setup. Once you have the roles, we request all formalities for all roles and finally the necessary KYC requirements.
The typical flow for an onboarding application and how the APIAX APIs play in are illustrated below.
Retrieve respective client onboarding rules
Create a request for the Client Classification API
You will need to request the Client Classification with entityType and entityTypeSpecific to retrieve all roles involved in your setup. To prepare the request you need to have the proper entityType and entityTypeSpecific values such as charitablePersonTrust, limitedPartnershipUnit, fixedInterestTrust or naturalPerson.
These values are country-specific. You can retrieve them with the Rule Inspection.
Use these values to populate your entityType and entitySpecificType dropdown fields which will appear in your application after the user has selected the country.
You then create a request to the Client Classification returning to you all involved roles.