Compléter un enrôlement

Une fois la demande d’enrôlement créée, le titulaire du futur compte peut finaliser son parcours de deux manières : via le portail CentralPay ou par intégration complète à l’API.

1. Option 1 – Compléter l’enrôlement via le portail CentralPay

Le lien d’accès à l’onboarding (généré ou reconstruit lors de la création d’enrôlement) permet au futur titulaire de compte de renseigner ses informations et d’uploader les documents demandés depuis l’interface CentralPay, de manière autonome.

• Vous êtes notifié automatiquement à chaque étape de l’enrôlement ou uniquement à sa finalisation (selon votre paramétrage webhook)
• Une fois le parcours complété par l’utilisateur, les données sont transmises aux équipes conformité de CentralPay pour validation
• Dans certains cas, des documents complémentaires pourront être requis par les analystes CentralPay

2. Option 2 – Compléter l’enrôlement par API

Il est également possible de piloter l’ensemble du parcours d’enrôlement via API, étape par étape.

Le processus suit 4 grandes phases :

1. Compléter le profil
2. Déterminer le workflow
3. Compléter le workflow
4. Finaliser l’enrôlement

2.1. Compléter le profil

Statut du profil

Un profil commence toujours avec un statut workflow.status = “ON_GOING”. Pour être considéré comme complété, ce statut doit devenir ACCEPTED.

⚠️ En mode SEQUENTIAL, ce statut peut revenir à ON_GOING lors du déblocage de questions supplémentaires. Il convient de le recontrôler à chaque étape.

Obtenir la première activité à compléter

• Récupérer l’activityUuid via : GET /api/nauth/merchant-enrollment/{enrollmentId}
• Parcourir : profile.workflow.activities[0].uuid
• Puis interroger : GET /api/nauth/profile/{activityUuid}/activity

Soumettre les données

Envoyer les données attendues via un formulaire : POST /api/nauth/profile/{activityUuid}/activity
Content-Type : multipart/form-data

Exemple de champs attendus (activité “Identity Informations”) :

Champ	Type	Contraintes
firstname[value]	string	255 caractères
lastname[value]	string	255 caractères
mail[value]	string	Email valide
phone[value]	string	Numéro international (min. 10 caractères)
birthday[value]	string	Date au format YYYY-MM-DD, entre 18 et 110 ans
place_of_birth[value]	string	—
country_of_birth[country]	string	ISO 3166-1 alpha-3

Autres types d’activité possibles :

• Domiciliations : informations d’adresse
• Pièce d’identité : type (IDENTITY_CARD, PASSPORT) + documents (2 fichiers pour carte, 1 pour passeport)

Répétez ce processus tant que le statut d’une activité reste “TODO”.

2.2. Déterminer le workflow

Cette étape débloque la suite du parcours (collecte de documents, justificatifs, etc.).

• POST /api/merchant-enrollment/{enrollmentUuid}/activity/{uuid}

Payload attendu :

Champ	Type	Obligatoire	Notes
type	Enum	✅ Oui	INDIVIDUAL, INDIVIDUAL_WITH_STATUS, LEGAL_ENTITY
bankAccountInEEACountry	bool	✅ Oui	—
turnover	UUID (36)	✅ Oui	POST /api/nauth/enrollment-claim/turnover
companyName	string(255)	Oui, si LEGAL_ENTITY	—
activityAge	UUID (36)	Oui, si LEGAL_ENTITY ou INDIVIDUAL_WITH_STATUS	GET /api/nauth/enrollment-claim/activity-age
subType	ENUM	Recommandé	Dépend du type (voir détails ci-dessous)
isCompany	bool	Oui, si LEGAL_ENTITY	—

Si vous avez utilisé un identityBadge (enrôlement via SIREN), cette étape est automatiquement sautée : le workflow est déjà déterminé.

2.3. Compléter le workflow

Chaque étape du workflow suit la même logique que celle du profil.

Types de step possibles :

• FORM : champs à renseigner via key[value]
• API_CALL : traitement externe
• VALIDATION : action manuelle par les équipes CentralPay
• ENDED : étape finalisée

Exemple : pour le champ company_legal_status, il faut envoyer company_legal_status[value].

Les endpoints utilisés sont :

• POST /api/merchant-enrollment/{merchantUuid}/activity/{uuid}
• POST /api/merchant-enrollment/{uuid}/complete