Compte de Monnaie Électronique limité

CentralPay permet la création de comptes de monnaie électronique (Wallets) pour stocker et utiliser des valeurs numériques. Deux parcours complémentaires sont proposés :

1. Création rapide d’un Wallet sans KYC (compte limité) : accessible immédiatement avec des plafonds réglementaires
2. Déplafonnement du Wallet via enrôlement KYC (compte vérifié) : levée des limites après vérification des documents

Ce fonctionnement est adapté aux parcours progressifs : un utilisateur peut créer un compte limité pour un premier usage, puis être invité à compléter son profil pour accéder à l’ensemble des fonctionnalités.

1. Création d’un compte de Monnaie Électronique limité

CentralPay permet la création de comptes de monnaie électronique utilisables immédiatement, sans collecte de documents, dans un cadre réglementaire strict. Les comptes de monnaie électronique limités sont réservés aux individuels (personnes physiques). Les personnes morales ne peuvent pas disposer de ce type de compte.

1.1. Limites réglementaires

• Solde maximal : 150 €
• Encaissement glissant : 150 € sur 30 jours

Ce seuil s’appuie sur les dispositions de l’article R561-16 du Code monétaire et financier concernant les comptes de monnaie électronique non vérifiés.

ℹ️ Ce type de compte peut ensuite être déplafonné par enrôlement KYC (voir plus bas).

1.2. Étape 1 – Créer un Customer

Le Wallet doit être rattaché à un objet Customer représentant l’utilisateur final (voir Profils Clients)

1.3. Étape 2 – Créer un Wallet

• POST /wallets

Champs obligatoires

Champ	Type	Description	Note
customerId	UUID	Identifiant du Customer	Requis sauf si merchantId est fourni
currency	string (3)	Devise du Wallet (ex. "EUR")	ISO 4217 – format 3 lettres

Champs optionnels

Champ	Type	Description
reference	string	Référence métier
activationDate	date	Date d’activation
expirationDate	date	Date d’expiration
additionalData	object	Données personnalisées (JSON)

1.4. Étapes complémentaires – Gérer un Wallet limité

Une fois un Wallet créé, CentralPay vous permet de :

• le modifier (ex. : ajouter une date d’expiration, une référence, un Merchant)
• le consulter en détail
• lister les Wallets existants pour un Customer ou Merchant

2. Modifier un Wallet

• POST /wallets/{walletId}

Ce service permet de mettre à jour certains attributs du Wallet sans le recréer.

Champs obligatoires

Champ	Type	Description	Note
walletId	UUID	Identifiant du Wallet à mettre à jour	Requis dans l’URL et/ou le corps de requête

Champs optionnels

Champ	Type	Description	Note
reference	string	Référence personnalisée du Wallet	—
expirationDate	date	Date d’expiration du Wallet	YYYY-MM-DD
activationDate	date	Date d’activation du Wallet	YYYY-MM-DD
additionalData	object	Données métier structurées (clé/valeur JSON)	—
merchantId	UUID	Pour rattacher un Wallet à un Merchant spécifique	Facultatif – à ne pas confondre avec customerId

3. Consulter un Wallet

• GET /wallets/{walletId}

Ce service permet de récupérer les informations détaillées d’un Wallet existant.

Paramètres requis

Champ	Type	Description	Note
walletId	UUID (36)	Identifiant du Wallet	Le Wallet doit appartenir au Merchant connecté ou à l’un de ses sous-marchands

Description des champs

Champ	Type	Description	Note
currency	string	Devise du Wallet	ISO 4217 (ex. EUR)
available[].amount	int	Solde disponible en centimes	Ex. : 10500 = 105,00 €
pending[].amount	int	Solde en attente (transactions en cours)	—
reference	string	Référence du Wallet	Facultatif
additionalData	object	Données personnalisées	JSON libre

4. Lister les Wallets d’un Customer

• GET /wallets

Permet d’obtenir la liste des Wallets créés pour un même Customer.

Paramètres requis

Champ	Type	Description
customerId	UUID	Identifiant du Customer
currency	string	Devise (ex. "EUR")

Paramètres optionnels

Champ	Type	Description	Note
after	string	Ne retourner que les Wallets créés après cette date	Format ISO 8601
before	string	Ne retourner que les Wallets créés avant cette date	Format ISO 8601
limit	string	Nombre d’éléments par page	Défaut : 10
page	string	Index de la page	Défaut : 1

5. Schéma de création d’un compte de ME limité