Intégration KYC (Know Your Customer)
Vous devez intégrer ces appels sur votre plateforme. De plus, veuillez consulter le document référence API pour identifier les paramètres obligatoires à implémenter.
Création de Compte et Onboarding d'un individu pour le KYC (Know Your Customer) est le processus par lequel Lemonway collecte et vérifie l'identité et d'autres informations pertinentes d'un nouveau client avant de lui permettre d'ouvrir un compte. Ce processus est crucial pour garantir la conformité aux exigences réglementaires, prévenir la fraude et gérer les risques. Il implique généralement la collecte de détails personnels tels que le nom, l'adresse, la date de naissance, et les documents d'identification, et peut inclure des étapes supplémentaires telles que la vérification biométrique ou les contrôles de crédit.
Point de Terminaison de Création de Compte
POST /accounts/individual
Réponse : Le point de terminaison de création de compte renvoie l'Id et le statut du compte créé. Si un onboarding est requis, la réponse indiquera en attente d'information.
Description : Cette méthode fournit les informations minimales nécessaires pour créer un compte individuel chez Lemonway. Avec ces informations, nous pouvons initier le processus d'onboarding. Si un onboarding KYC est requis, vous pouvez générer un lien vers un formulaire d'onboarding associé à ce compte. Ce lien peut ensuite être envoyé à votre utilisateur pour soumettre les données et documents essentiels nécessaires à l'onboarding.
Exemple :
{
"individual": {
"firstName": "Johnathan",
"lastName": "Lamary",
"birthDate": "1973-06-01T10:10:57.870Z",
"email": "JLamry55@gmail.com",
"birthCity": "Paris",
"birthCountry": "FR",
"phoneNumber": "+33675869559",
"nationalities": ["FR", "GB"],
"address": {
"street": "24 rue des peupliers",
"complementaryStreetInfo": "bis",
"postalCode": "92130",
"city": "Issy",
"residenceCountry": "FR"
}
},
"profile": "PROJECT_HOLDER",
"walletId": "f2470b35-4dd4-4fe1-bab2-f8c763ebcef5",
"solutionName": "lemonway"
}Point de Terminaison Onboarding
Si un individu n'a pas encore initié un processus d'onboarding, vous devrez appeler le point de terminaison des onboardings. Cet appel génère un id unique et une url correspondant au compte individuel.
POST /onboardings/individual
Description : Cet appel est requis lorsqu'un individu a créé un compte et que le statut renvoyé est "en attente d'information". Les informations fournies par l'individu permettent à Lemonway de procéder à différents contrôles et de vérifier l'identité de l'individu.
Exemple :
{
"individual": {
"firstName": "Johnathan",
"lastName": "Lamary",
"birthDate": "1973-06-01T10:10:57.870Z",
"email": "JLamry55@gmail.com",
"birthCity": "Paris",
"birthCountry": "FR",
"phoneNumber": "+33675869559",
"nationalities": ["FR", "GB"],
"address": {
"street": "24 rue des peupliers",
"complementaryStreetInfo": "bis",
"postalCode": "92130",
"city": "Issy",
"residenceCountry": "FR"
},
"politicalExposure": {
"startDate": "2023-06-01T10:10:57.870Z",
"endDate": "2029-06-01T10:10:57.870Z",
"position": "POLITICAL_LEADER",
"status": "YES"
},
"financialSituation": {
"annualRevenue": "FIRST_TIER",
"estimatedWealth": "FIRST_TIER",
"hasIFItax": true,
"taxCode": "235 6376"
},
"legalCapacity": {
"type": "PROTECTED_ADULT"
},
"professionalSituation": {
"activity": "69"
}
},
"project": {
"type": "WEDDING",
"weddingRelation": "BRIDE_GROOM",
"description": "project description",
"website": "project.url"
}
}Point de Terminaison Reprise
Le point de terminaison resume permet à un individu de reprendre son onboarding là où il s'est arrêté. Ce point de terminaison génère une url unique correspondant à la progression de l'onboarding en ligne de l'individu.
GET /onboardings/{accountId}/resume
{
"url": "https://onboarding.lemonway.com/t2/e35ffdb3-b185-42fe-8413-06ecba7b2d30/welcome"
}