Demande d’enrôlement

1. Méthodes de création d’une demande d’enrôlement

1.1. Depuis le portail Marchand CentralPay

Un utilisateur connecté au portail CentralPay peut initier une demande d’enrôlement depuis le menu : Plateforme > Enrôlements > Créer

Il peut alors renseigner manuellement les champs décrits plus bas (dans le détail de l’appel API). Une fois la demande enregistrée, un lien de redirection vers le portail d’onboarding est généré automatiquement et peut être :

• Envoyé automatiquement par e-mail via le Mailer CentralPay (sélectionner OUI dans le champ « Envoyer des emails à l’adresse ci-dessus »)
• Ou copié manuellement pour un envoi par un autre canal (chat, SMS, etc.)

1.2. Depuis l’API : POST /merchant-enrollments

L’enrôlement peut aussi être initié automatiquement via l’API, en appelant : POST /merchant-enrollments

L’appel permet de générer un identifiant d’enrôlement (UUID) et d’initier un parcours d’onboarding complet, qui pourra être poursuivi :

• Soit via le portail Marchand
• Soit entièrement via les endpoints API (voir partie « Compléter un enrôlement par API »)

Si aucun lien direct (enrollment_url) n’est retourné par l'API, par défaut, la plateforme CentralPay envoie un e-mail à l'adresse définie dans profile[email][value].
Pour désactiver cet envoi : "sendClaimEmail": false

Si vous désactivez l'envoi, vous pouvez transmettre manuellement l'URL d’accès à l'interface onboarding en reconstituant :
- En RCT : https://test-onboarding.centralpay.net/token/profile/[UUID]
- En PROD : https://onboarding.centralpay.net/token/profile/[UUID]

Note : [UUID] est l’identifiant retourné dans la réponse à POST /merchant-enrollments.

2. Créer une demande d’enrôlement depuis l’API (Merchant Enrollment)

🇫🇷 Enrôlement simplifié via SIREN (France uniquement)
CentralPay permet de pré-remplir automatiquement certaines informations pour les sociétés françaises disposant d’un numéro SIREN :
1. Appeler l'endpoint : POST /api/legal-entity/siren
2. Fournir le champ : { "siren": "123456789" }
3. Si les informations sont valides, un UUID est retourné. Il doit être utilisé comme identityBadge dans la création d’enrôlement pour déclencher le parcours simplifié.

2.1. Champs requis

Champ	Type	Obligatoire	Description
profile[firstname][value]	string (255)	✅ Oui	Prénom du titulaire. Validation : caractères alphabétiques et tirets (-). Depuis la version 1.15.0
profile[lastname][value]	string (255)	✅ Oui	Nom du titulaire. Validation : caractères alphabétiques et tirets (-). Depuis la version 1.15.0
profile[email][value]	string (255)	✅ Oui	Adresse email de contact. Depuis la version 1.15.0
profile[phone][value]	string	✅ Oui	Numéro de téléphone international. Depuis la version 1.15.0
language	string	✅ Oui	Langue préférée du marchand. Note : utilisez GET /api/locale pour les valeurs disponibles.
accountType	enum	✅ Oui	Type de profil marchand à créer. Note : utilisez GET /api/merchant-enrollment/account-type.
activitySector	UUID (36)	✅ Oui	Secteur d’activité du marchand. Note : utilisez GET /api/nauth/enrollment-claim/activity-sector.
activityAge	UUID (36)	✅ Oui, si type = LEGAL_ENTITY ou INDIVIDUAL_WITH_STATUS	Ancienneté de l’activité. Note : utilisez GET /api/nauth/enrollment-claim/activity-age.
feeSchedule	UUID (36)	✅ Oui	Grille tarifaire à appliquer. Note : obtenez les identifiants via POST /api/merchant-enrollment/fee-schedule.
identityBadge	UUID	✅ Oui, si enrôlement via SIREN	Identifiant SIREN (activant le parcours simplifié).
contract	UUID	✅ Oui, si accountType = STANDARD	Contrat à appliquer. Note : utilisez GET /api/merchant-enrollment/contract.

2.2. Champs avancés (optionnels)

Personnalisation du parcours

Champ	Valeur par défaut	Description
workflowMode	SEQUENTIAL	Mode de déroulement du parcours (seul le mode SEQUENTIAL est désormais disponible). Note : valeurs valides : SEQUENTIAL
type	—	Type juridique : INDIVIDUAL, INDIVIDUAL_WITH_STATUS, LEGAL_ENTITY. Note : conditionne la structure du parcours.
subType	—	Sous-type recommandé selon type. Note : Pour INDIVIDUAL_WITH_STATUS : SOLE_TRADER, MERCHANT, ARTISAN Pour LEGAL_ENTITY : ASSOCIATION, PUBLIC, COMMERCIAL, EIG, CIVIL
turnoverIsFixed	false	Si true, verrouille la déclaration de chiffre d’affaires. Note : facultatif

Paramètres de communication

Champ	Valeur par défaut	Description
sendClaimEmail	true	Envoie l’e-mail d’enrôlement avec le lien portail.
allowedEmailCommunication	true	Si false, désactive tous les envois d’e-mails pendant le parcours d’onboarding.
sendProfileCreationEmail	false	Envoie un email à l’utilisateur une fois le profil complété.
sendAccountCreationEmail	true	Envoie un email une fois le profil Marchand CentralPay activé.

Données personnelles

Tous les champs ci-dessous sont facultatifs mais permettent de pré-renseigner la constitution du profil utilisateur du futur titulaire du compte.

Champ	Type	Description
profile[nationality][country]	string (3)	Nationalité (format ISO 3166-1 alpha-3).
profile[birthday][value]	date	Date de naissance. Validation : ≥ 18 ans, ≤ 110 ans
profile[place_of_birth][value]	string	Lieu de naissance.
profile[country_of_birth][country]	string (3)	Pays de naissance (ISO 3166-1 alpha-3).
birthdayConfirmation[value]	date	Requis uniquement si le marchand est affilié à un agent. Format : YYYY-MM-DD

Adresse (optionnelle)

Ces champs peuvent être fournis pour pré-remplir l’adresse du titulaire.

Champ	Type	Description
profile[address][nameLine1]	string(255)	Ligne 1 de l’adresse. Contraintes : ^[a-zA-Z0-9\\p{L} ´'\\-]{1,255}$
profile[address][locality]	string(255)	Ville.
profile[address][postalCode]	string(20)	Code postal.
profile[address][country]	string(3)	Pays (ISO 3166-1 alpha-3).

Autres options

Champ	Type	Description
contract	UUID (36)	Contrat à appliquer. Obligatoire si accountType = STANDARD. Note : GET /api/merchant-enrollment/contract
cgu	UUID (36)	CGU à appliquer. Note : POST /api/merchant-enrollment/cgu Depuis version 1.18.0
customReference	string (100)	Référence personnalisée (usage interne).
payoutProfile	UUID (36)	Profil de versement à associer. Note : POST /api/merchant-enrollment/payout-profile
administrativeContact	string (255)	Contact administratif référent. Depuis version 1.18.0
technicalContact	string (255)	Contact technique. Depuis version 1.18.0
financialContact	string (255)	Contact financier. Depuis version 1.18.0
addSecurityReference	bool	Affiche une référence de sécurité lors de la validation du contrat. Uniquement valable pour : STANDARD, PARTNER, RESELLER. Défaut : false
hook	UUID	Identifiant de webhook à notifier. Note : voir onglet Full API reference pour obtenir les valeurs possibles.