Déplafonner un compte de Monnaie Électronique

Estimated reading: 7 minutes

Un Wallet peut être converti en compte vérifié (limites levées) via un enrôlement complet, déclenché par l’API.

1. Étape 1 – Créer un enrôlement

POST /merchant-enrollments

Vous devez inclure le walletId du Wallet limité existant.

Champs obligatoires

Champ	Type	Description	Note
`walletId`	UUID	Lien avec le Wallet ME à déplafonner	UUID valide
`profile[firstname][value]`	string (255)	Prénom	Alpha + `-`
`profile[lastname][value]`	string (255)	Nom	Alpha + `-`
`profile[email][value]`	string (255)	Email de contact	—
`profile[phone][value]`	string (15)	Téléphone international	—
`profile[birthday][value]`	date (`YYYY-MM-DD`)	Date de naissance	Entre 18 et 110 ans
`profile[place_of_birth][value]`	string (255)	Lieu de naissance	—
`profile[country_of_birth][country]`	string (3)	Pays de naissance	ISO 3166-1 alpha-3
`language`	string (3)	`"fr"` ou `"en"`	—
`accountType`	string	`"BASIC"`	—
`type`	string	`"INDIVIDUAL"`	—
`activitySector`	UUID (36)	Secteur d’activité	`GET /api/nauth/enrollment-claim/activity-sector`
`feeSchedule`	UUID (36)	Grille tarifaire	`POST /api/merchant-enrollment/fee-schedule`
`turnover`	UUID (36)	CA annuel attendu	`POST /api/nauth/enrollment-claim/turnover`
`workflowDefinition`	UUID	Modèle de workflow	fournie par CentralPay
`profileWorkflowDefinition`	UUID	Modèle de profil	fournie par CentralPay
`workflowMode`	string	`"SEQUENTIAL"`	Requis
`allowedEmailCommunication`	boolean	Consentement à recevoir des emails	`true` ou `false`

Champs facultatifs

Champ	Type	Description
`sendClaimEmail`	boolean	Envoi de l’e-mail d’enrôlement (défaut : `true`)
`sendProfileCreationEmail`	boolean	Email après profil complété
`sendAccountCreationEmail`	boolean	Email à l’ouverture du compte vérifié
`customReference`	string	Référence interne
`technicalContact`, `administrativeContact`, `financialContact`	string(255)	Contacts métiers
`addSecurityReference`	boolean	Affiche une référence sécurité (pour `STANDARD`, `PARTNER`, `RESELLER`)
`hook`	UUID	Hook technique
`birthdayConfirmation[value]`	date	Si affilié à un agent

2. Étape 2 – Compléter un enrôlement KYC (via autocomplete)

Pour accélérer le processus d’enrôlement, vous pouvez compléter d’un seul coup toutes les données attendues en appelant :

POST /merchant-enrollment/{uuid}/autocomplete

Adresse de résidence

Champ	Type	Obligatoire	Description	Note
`address[nameLine1]`	string	✅ Oui	Numéro et nom de rue	—
`address[locality]`	string	✅ Oui	Ville de résidence	—
`address[postalCode]`	string	✅ Oui	Code postal	—
`address[country]`	string	✅ Oui	Pays de résidence	ISO 3166-1 alpha-3

Document d’identité

Champ	Type	Obligatoire	Description	Note
`identityDocument[type]`	string	✅ Oui	Type de document	`IDENTITY_CARD`, `PASSPORT`, `RESIDENCE_PERMIT`, `VISA`, `IDENTITY_DOCUMENT_RECEIPT`
`identityDocument[documents][0]`	fichier	✅ Oui	Recto ou scan principal	JPG, JPEG ou PNG
`identityDocument[documents][1]`	fichier	✅ Oui, si `IDENTITY_CARD`	Verso ou page complémentaire	JPG, JPEG ou PNG
`identityDocument[issuingCountry]`	string	✅ Oui	Pays émetteur	ISO 3166-1 alpha-3
`identityDocument[expiryDate]`	string	❌ Non	Date d’expiration	Format `YYYY-MM-DD`
`identityDocument[checkId]`	string	❌ Non	ID de contrôle (Onfido)	—
`identityDocument[documentNumber]`	string	❌ Non	Numéro du document	—
`identityDocument[mrzLine1]`	string	❌ Non	Ligne MRZ 1	—
`identityDocument[mrzLine2]`	string	❌ Non	Ligne MRZ 2	—

Cas particuliers

Champ	Obligatoire	Condition	Description
`identityDocument[proofOfIdentityDocument]`	✅ Oui	si `type = IDENTITY_DOCUMENT_RECEIPT`	Justificatif visuel du récépissé
`identityDocument[proofOfIdentityDocuments][*]`	✅ Oui	idem	Plusieurs fichiers si applicable
`identityDocument[proofOfIdentityDocumentExpiryDate]`	✅ Oui	si fichier `proofOfIdentityDocument` fourni	Format `YYYY-MM-DD`

Données bancaires (facultatif mais recommandé)

Champ	Type	Obligatoire	Description	Note
`iban[value]`	string	❌ Non	IBAN à vérifier	Format IBAN valide
`bic[value]`	string	❌ Non	Code BIC/SWIFT	—
`ibanDocument[document]`	fichier	❌ Non	Justificatif bancaire (RIB, relevé)	JPG, JPEG ou PNG

Données KYC complémentaires (riskData)

Tous les champs suivants sont requis sauf mention contraire.

Champ	Type	Obligatoire	Description	Note
`riskData[isPep]`	bool	✅ Oui	Personne politiquement exposée ?	défaut : `false`
`riskData[isInSanctionList]`	bool	✅ Oui	Appartient à une liste de sanctions ?	défaut : `false`
`riskData[residentAlpha3Code]`	string	✅ Oui	Pays de résidence	ISO 3166-1 alpha-3
`riskData[isHighRiskResident]`	bool	✅ Oui	Pays de résidence à risque ?	—
`riskData[nationalityAlpha3Code]`	string	✅ Oui	Nationalité	ISO 3166-1 alpha-3
`riskData[isHighRiskNationality]`	bool	✅ Oui	Nationalité à risque ?	—
`riskData[isHighRiskMCCActivitySector]`	bool	✅ Oui	Secteur MCC à risque ?	—
`riskData[MCCActivitySector]`	int	✅ Oui	Code MCC (NAF ou secteur)	—
`riskData[monthlyLimit]`	int	✅ Oui	Limite mensuelle déclarée (en centimes)	Ex. 150000 = 1500,00 €
`riskData[monthlyLimitCurrencyAlphabeticCode]`	string	✅ Oui	Devise (ex. `EUR`)	ISO 4217
`riskData[isCrossBorderPayment]`	bool	❌ Non	Paiements transfrontaliers ?	Défaut : `true`
`riskData[declaredMonthlyRevenue]`	int	❌ Non	Revenus déclarés (en centimes)	—
`riskData[verifiedMonthlyRevenue]`	int	✅ Oui, si full KYC	Revenus vérifiés	—

Documents complémentaires (si requis)

Champ	Type	Obligatoire	Description	Note
`proofOfAddressDocument[documents][0]`	fichier	✅ Oui, si profil à risque	Justificatif de domicile	JPG, JPEG ou PNG
`incomeDocument[document]`	fichier	✅ Oui, si full KYC requis	Justificatif de revenus (1 doc)	JPG, JPEG ou PNG
`incomeDocument[documents][*]`	fichier	✅ Oui, si full KYC requis	Plusieurs fichiers possibles	JPG, JPEG ou PNG

Autres documents (si nécessaires à la levée de limite)

Champ	Type	Description	Notes
`additionalDocuments[X]['type']`	string	Type du document transmis	Ex. : `UBO_DECLARATION`, `PROOF_OF_VAT_REGISTRATION`, `LICENSING_AGREEMENT`, etc.
`additionalDocuments[X]['documents'][X]`	fichier	Fichier transmis	Format : JPG, JPEG, PNG

ℹ️ La liste complète des types de document acceptés est documentée dans l'Open API.

Données libres (obligatoire même vide)

Champ	Type	Obligatoire	Description
`metaData`	JSON object	✅ Oui	Métadonnées libres, au format `{"key": "value"}` (peut être vide)

3. Étape 3 – Corriger un enrôlement rejeté (autoupdate)

Lorsque le service conformité refuse un ou plusieurs documents (ex. : carte d’identité floue, pièce expirée), vous pouvez soumettre uniquement les éléments refusés via une requête d’auto-mise à jour.

POST /merchant-enrollment/{uuid}/autoupdate

Correction de document d’identité

Champ	Type	Obligatoire	Description	Note
`identityDocument[type]`	string	✅ Oui	Type de document à corriger	`IDENTITY_CARD`, `PASSPORT`, `RESIDENCE_PERMIT`, `VISA`, `IDENTITY_DOCUMENT_RECEIPT`
`identityDocument[documents][0]`	fichier	✅ Oui	Recto du document (ou fichier unique)	JPG, JPEG ou PNG
`identityDocument[documents][1]`	fichier	✅ Oui, si `type = IDENTITY_CARD`	Verso de la CNI	JPG, JPEG ou PNG
`identityDocument[issuingCountry]`	string	✅ Oui, si document transmis	Pays émetteur	ISO 3166-1 alpha-3

Document d’identité complémentaire (si requis)

Champ	Type	Obligatoire	Description
`complementaryIdentityDocument[documents][0]`	fichier	✅ Oui, si exigé	Scan ou photo supplémentaire
`complementaryIdentityDocument[expiryDate]`	string	✅ Oui	Date d’expiration (`YYYY-MM-DD`)
`complementaryIdentityDocument[documentNumber]`	string	✅ Oui	Numéro du document
`complementaryIdentityDocument[mrzLine1]`	string	✅ Oui	MRZ ligne 1
`complementaryIdentityDocument[mrzLine2]`	string	✅ Oui	MRZ ligne 2
`complementaryIdentityDocument[issuingCountry]`	string	✅ Oui	Pays émetteur (ISO alpha-3)

Documents de revenus

Champ	Type	Obligatoire	Description
`incomeDocument[document]`	fichier	✅ Oui, si requis	Fichier unique JPG/JPEG/PNG
`incomeDocument[documents][*]`	fichier	✅ Oui, si multiples attendus	Plusieurs documents par index (`[0]`, `[1]`, etc.)

Compléments d’information personnelle

Champ	Type	Obligatoire	Description
`profile[firstname][value]`	string	❌ Non	Prénom
`profile[lastname][value]`	string	❌ Non	Nom
`profile[birthday][value]`	string	❌ Non	Date de naissance
`profile[place_of_birth][value]`	string	❌ Non	Lieu de naissance
`profile[country_of_birth][country]`	string	❌ Non	Pays de naissance (ISO 3166-1 alpha-3)

Correction d’adresse (si refusée)

Champ	Type	Obligatoire	Description
`profile[address][nameLine1]`	string	❌ Non	Adresse – ligne 1
`profile[address][postalCode]`	string	❌ Non	Code postal
`profile[address][country]`	string	❌ Non	Pays (ISO alpha-3)
`profile[address][locality]`	string	❌ Non	Ville

Mise à jour des données KYC (riskData)

Tous les champs suivants sont requis sauf mention contraire. Ils doivent être renvoyés à l’identique ou mis à jour si modifiés dans le cadre de la correction.

Champ	Type	Obligatoire	Description	Note
`riskData[isPep]`	boolean	✅ Oui	PEP ?	défaut : `false`
`riskData[isInSanctionList]`	boolean	✅ Oui	Sur une liste de sanctions ?	défaut : `false`
`riskData[residentAlpha3Code]`	string	✅ Oui	Pays de résidence	ISO alpha-3
`riskData[isHighRiskResident]`	boolean	✅ Oui	Pays de résidence à risque ?	—
`riskData[nationalityAlpha3Code]`	string	✅ Oui	Nationalité	ISO alpha-3
`riskData[isHighRiskNationality]`	boolean	✅ Oui	Nationalité à risque ?	—
`riskData[isHighRiskMCCActivitySector]`	boolean	✅ Oui	Secteur à risque ?	—
`riskData[MCCActivitySector]`	int	✅ Oui	Code MCC métier	—
`riskData[monthlyLimit]`	int	✅ Oui	Limite mensuelle (en centimes)	[0 ; 190000]
`riskData[monthlyLimitCurrencyAlphabeticCode]`	string	✅ Oui	Devise (ex. EUR)	ISO 4217
`riskData[isCrossBorderPayment]`	boolean	❌ Non	Paiements transfrontaliers	défaut : `true`
`riskData[declaredMonthlyRevenue]`	int	❌ Non	Revenus déclarés	—
`riskData[verifiedMonthlyRevenue]`	int	✅ Oui, si full KYC	Revenus vérifiés (centimes)

Documents additionnels (optionnels ou exigés)

Champ	Type	Obligatoire	Description
`additionalDocuments[X]['type']`	string	✅ Oui, si documents attendus	Type du justificatif
`additionalDocuments[X]['documents'][X]`	fichier	✅ Oui	Fichiers associés (JPG, JPEG, PNG)

Autres champs

Champ	Type	Obligatoire	Description
`fullKyc`	boolean	❌ Non	Permet d’imposer un KYC complet ou simplifié (`true` / `false`)

4. Étape 4 – Suivre le statut d’un enrôlement

Une fois un enrôlement créé et complété, vous pouvez à tout moment interroger son statut pour :

Vérifier l’état d’avancement (ON_GOING, ACCEPTED, REFUSED)
Suivre les étapes en attente dans le workflow
Extraire les données de profil déjà soumises

Récupérer un enrôlement

GET /merchant-enrollment/{enrolmentId}

Paramètres requis

Champ	Type	Obligatoire	Description	Note
`enrolmentId`	UUID (36)	✅ Oui	Identifiant de l’enrôlement retourné lors de la création (`POST /merchant-enrollments`)	Format UUID standard

ℹ️ L’enrôlement doit appartenir à l’espace autorisé par vos identifiants API (marchand ou sous-marchand).

Champs principaux de la réponse

Champ	Type	Description
`uuid`	UUID	Identifiant unique de l’enrôlement
`workflow.status`	string	Statut du processus (`ON_GOING`, `ACCEPTED`, `REFUSED`)
`workflow_mode`	string	`"SEQUENTIAL"` ou `"CONTINUAL"`
`workflow.activities[]`	tableau	Liste des activités (étapes) encore à compléter
`profile[...]`	objet	Données de profil déjà soumises, avec leur statut
`conformity_status`	string	État de conformité global (`ON_GOING`, `REVIEW`, `APPROVED`, etc.)
`created_at`	datetime	Date de création de l’enrôlement
`activity_sector.name`	string	Secteur déclaré dans l’enrôlement

À surveiller

Tant qu’une activité a un state = TODO, l’enrôlement est incomplet
Lorsqu’aucune activité n’est en attente et que le workflow.status = ACCEPTED, l’utilisateur est validé
En cas de workflow.status = REFUSED, aucun Wallet vérifié ne sera généré