Un même argent.
Plusieurs regards.
Chaque franc expliqué.

Version de conception du 14 novembre 2026. Ce référentiel fixe le fonctionnement du registre opérationnel à réaliser et à confronter à l’implémentation. Il ne décrit pas un logiciel audité. Les identifiants OP sont notre nomenclature de contrôle ; ce ne sont pas des numéros de comptes SYSCOHADA imposés à la société.

1. Ce que nous construisons

Kelyko doit pouvoir expliquer chaque montant : d’où il vient, à qui il appartient, où il est représenté, pourquoi il est disponible ou bloqué, et quelle preuve justifie son dernier mouvement.

Nous retenons comme parcours central l’encaissement attribué à un marchand dans le dispositif financier partenaire, son suivi en quatre compartiments et le reversement contrôlé. L’individualisation peut être portée par un compte ou une position chez le gestionnaire : les écritures opérationnelles ci-dessous restent les mêmes. L’identité et le numéro bancaire sont des données de configuration du compte externe, pas des conditions pour définir le jeu d’écritures.

Le même référentiel distingue un paiement déjà crédité directement sur un compte marchand librement utilisable : ce paiement ne doit pas recréer une deuxième dette à reverser dans Kelyko.

Les règles sont formulées au présent comme règles de conception, les comportements fournisseur comme faits documentés, et les relations privées rapportées comme déclarations du fondateur. Une déduction comptable est expliquée comme telle. La rédaction n’attribue pas à Kelyko un agrément ou une émission de monnaie.

2. Les acteurs : chacun porte une fonction précise

Une même institution peut tenir plusieurs rôles ; un rôle ne signifie pas qu’il faut créer une société supplémentaire. Un prestataire purement logiciel n’est pas automatiquement le détenteur juridique des fonds. Les responsabilités du gestionnaire ne dispensent pas les acteurs techniques et commerciaux de leurs propres responsabilités.

Le document joint rapporte une chaîne de partenaires nommés. Nous conservons ces noms et propos dans la fiche privée de source ; le schéma pédagogique utilise les fonctions ci-dessus. Un BIN sponsoring concerne un programme d’émission carte : il n’établit à lui seul ni l’acquisition e-commerce ni un accès de production à PI-SPI.

3. Cinq couches, une seule valeur économique

Le relevé bancaire, le registre partenaire et le miroir Kelyko ne constituent pas trois réserves d’argent. Le même 10 000 observé sur trois couches reste 10 000. Le contrôle consiste à expliquer les correspondances, pas à additionner les vues.

Les échanges API transportent des instructions et des preuves. Ils ne transportent pas un deuxième exemplaire des fonds et ne prouvent pas à eux seuls le titulaire d’un compte bancaire.

4. UV : ce qui augmente, ce qui diminue

Une unité de valeur de monnaie électronique est une créance sur son émetteur, dans le cadre qui régit cette émission. Le solde de suivi Kelyko n’est pas une nouvelle monnaie électronique. Monnaie électronique : définitions, émission et contrepartie.

La quantité d’UV du payeur et celle d’un autre émetteur peuvent évoluer lors d’un paiement interétablissements. La correspondance précise dépend du type de compte crédité. Nous ne présentons donc pas chaque paiement comme une recharge suivie d’un retrait physique obligatoire. Réserver 9 135 XOF dans le portail ne détruit aucune UV.

Les XOF du registre sont des montants économiques entiers. Les API de référence peuvent utiliser amountCents : 10 000 XOF correspondent alors à 1 000 000 unités techniques. Cette conversion n’est ni un taux de change ni une émission d’UV. Unité de transfert documentée.

5. Les comptes qu’il faut distinguer

Le cantonnement protège ; la liquidité permet d’exécuter ; le registre attribue ; l’exploitation finance l’entreprise. Ces fonctions ne sont pas quatre étapes obligatoires que traverse chaque franc.

L’article 48 de l’instruction 001-01-2024 traite de la protection des fonds des utilisateurs des établissements de paiement et du rapprochement des comptes ; l’article 44 exige une liquidité suffisante. Ce régime n’est pas appliqué indistinctement à une banque, à un émetteur de ME et à un éditeur logiciel. Instruction services de paiement.

La modification du 8 octobre 2026 concerne les articles 31 et 34 du régime ME. Son minimum de 65 % en dépôts à vue concerne les placements de la contrepartie d’un émetteur ; il ne donne pas à Kelyko le droit d’utiliser le reste des fonds marchands. Instruction 020.

6. Plan de comptes du livre de contrôle

Ce livre est un auxiliaire de contrôle multi-marchands. Les rubriques de position et de droit sont économiques ; elles ne reconnaissent pas automatiquement ces actifs et dettes au bilan statutaire de la société Kelyko.

Une rubrique est ventilée par gestionnaire, compte externe, devise, marchand et magasin selon sa nature. Chaque ligne possède son propriétaire économique. Les montants consolidés restent calculés à l’intérieur d’un périmètre de livre et de devise.

Pour lire les écritures sans être comptable : débiter une position d’actif l’augmente ; la créditer la diminue. Créditer un droit ou une dette l’augmente ; le débiter le diminue. Ainsi, débiter « disponible » et créditer « réservé » déplace le droit marchand, sans sortie bancaire. Le mot « crédit » de la banque, celui du portail et le sens comptable d’une ligne doivent être interprétés dans le livre concerné.

Une créance à recevoir n’est pas de la trésorerie disponible. Le transit n’est pas un deuxième droit marchand. Une avance n’est pas un revenu. Une retenue n’est pas une commission.

La preuve d’un crédit au solde partenaire et la preuve du règlement interparticipants sont deux faits distincts. OP.102 suit le premier lorsqu’il est justifié dans le dispositif ; il ne certifie pas les comptes de règlement internes à la banque. Toute disponibilité antérieure à un règlement sous-jacent doit être autorisée et financée dans le dispositif, sans inventer un crédit accordé par Kelyko.

7. Les quatre compartiments du marchand

Droit net encore dû = en attente + disponible + réservé + retenu. Chaque franc appartient à un seul compartiment à un instant donné.

Le réservé peut subsister alors que le compte externe a déjà été débité : OP.103 explique alors la valeur en transit. On ne déduit pas simultanément le transit du droit marchand une deuxième fois.

Les quatre compartiments sont une règle du produit Kelyko. La documentation d’un fournisseur peut exposer un simple balance ou exclure certains fonds conditionnels : il faut une correspondance documentée, pas une égalité aveugle entre les libellés.

8. Le cycle complet : 10 000 → 9 000 versés + 715 restant dus + 285 de frais

Exemple pédagogique en XOF, avec les tarifs Mobile Money décidés pour Kelyko : entrée 1,5 %, sortie 1,5 % ajoutée au montant envoyé. Les frais de 285 ne préjugent pas de leur partage. Le tableau suppose, pour rendre la conservation visible, que les frais restent dans le périmètre suivi avant règlement aux ayants droit. Le cas du règlement déjà net est expliqué juste après.

À l’étape 6 : position externe suivie 1 000 = 715 de droit marchand + 285 de frais à répartir. Après remise des 285 aux ayants droit, la position clients restante est 715. À toutes les étapes, débits = crédits.

Si le débit et la confirmation arrivent ensemble, les étapes 5 et 6 peuvent être comptabilisées dans une même transaction atomique : débit OP.203 de 9 135 ; crédits OP.102 de 9 000 et OP.210 de 135. Les étapes ne sont pas toutes des requêtes API séparées.

9. Si le partenaire règle déjà un montant net

Pour le paiement précédent, le partenaire peut remettre 9 850 et avoir prélevé 150. La constatation du brut reste : débit OP.101 10 000, crédits OP.201 9 850 et OP.210 150.

Le règlement net, si le relevé établit que les 150 ont été entièrement remis à leurs ayants droit, se traduit par : débit OP.102 9 850, débit OP.210 150, crédit OP.101 10 000. Le droit marchand reste 9 850. On ne soustrait jamais encore 150 au marchand.

Si une part des 150 revient à Kelyko mais n’est pas encore versée, elle demeure une créance de commission à suivre dans le livre propre de la société et une dette chez son débiteur. On ne prétend pas qu’elle se trouve dans la position bancaire clients de 9 850.

Si le prélèvement externe ne correspond pas au montant attendu, l’écart reste identifié et investigué. Une écriture qui équilibre le journal n’autorise pas à qualifier arbitrairement l’écart de commission acquise.

Pour un règlement agrégé de deux paiements de 10 000 et 20 000, les confirmations totalisent un débit OP.101 de 30 000, des crédits marchands en attente de 9 850 et 19 700, et des frais de 450. Si le relevé remet 29 550 et justifie 450 de frais prélevés : débit OP.102 29 550, débit OP.210 450, crédit OP.101 30 000. Les deux paiements gardent leurs références et leurs bénéficiaires ; le lot de règlement n’est pas une nouvelle vente.

10. Le même paiement chez les autres acteurs

Les jeux ci-dessous exposent les fonctions comptables. Les noms exacts et la séquence de règlement relèvent du livre de l’institution ; aucun numéro de compte BCEAO interne n’est inventé.

Lorsque banque et gestionnaire sont une même personne morale, on ne crée pas artificiellement le livre d’un gestionnaire distinct. Lorsque le bénéficiaire est le marchand lui-même et que son compte est directement crédité, sa banque lui doit le dépôt : Kelyko ne lui doit pas en plus les mêmes 10 000.

Pour une sortie vers un wallet, l’établissement destinataire crédite le droit du titulaire du wallet et reçoit sa contrepartie de règlement. Le prestataire technique n’a pas besoin de devenir lui-même émetteur de ces UV.

Pour la carte, séparer autorisation, capture, règlement acquéreur et disponibilité. Une autorisation seule ne justifie pas d’afficher le net comme encaissé et retirable. La créance du circuit est constatée sur l’événement financier approprié ; le règlement crédite la position et solde cette créance ; les risques de remboursement ou contestation restent identifiés. Le délai ou la réserve ne sont pas copiés d’un tarif Mobile Money.

Pour PI-SPI, la demande de paiement sollicite l’autorisation : sa simple création ne crédite pas le marchand. Le résultat financier et ses références sont rapprochés avec les données du participant. Les étapes logiques ne permettent pas d’inventer une chambre de compensation supplémentaire ou d’attribuer automatiquement à PI-SPI la mécanique SICA/STAR. Le livre source et le livre destinataire se raccordent par le montant, les participants, les références et les preuves du circuit réellement employé.

11. Dans la comptabilité propre du marchand

Pour illustrer le suivi de paiement, nous partons d’une facture de 10 000 déjà constatée. Les écritures de vente, TVA et reconnaissance du produit ne sont pas redéfinies ici.

La créance client est soldée une fois : le versement ultérieur n’est pas une deuxième vente. Si le paiement est directement crédité au compte propre du marchand, la contrepartie de la première ligne est sa banque/wallet au lieu d’une créance à reverser.

12. Frais, partage et comptabilité de la société

Volume encaissé ≠ frais facturés ≠ rémunération Kelyko ≠ marge. La documentation Service Provider précise que fees est le montant facturé au marchand, sans exposer son partage interne. La rémunération du SP dépend du catalogue effectivement assigné et de la clé employée. Catalogues et frais.

Pour 285 de frais constatés, la ventilation du livre de contrôle est : débit OP.210 285 ; crédits OP.211 part partenaire, OP.212 part Kelyko, OP.213 taxes identifiées ; leur somme vaut 285. Les parts ne sont renseignées qu’avec les règles de partage. Le journal peut conserver OP.210 en attendant cette attribution : il n’a pas à inventer une marge.

Dans le livre statutaire de la société Kelyko : lorsqu’une rémunération de K lui est effectivement acquise, débit créance de commission K et crédit produit de prestation K, avec le traitement fiscal applicable. À son versement : débit banque d’exploitation K, crédit créance K. Les charges propres de la société suivent séparément. L’analyse principal/agent, le contrat et le référentiel applicable déterminent une présentation brute ou nette : le seul champ fees ne suffit pas à décider.

L’intermédiaire qui encaisse pour plusieurs marchands ne transforme pas leur volume en chiffre d’affaires. Les frais non remboursables documentés par un fournisseur ne sont pas automatiquement rendus remboursables dans Kelyko. Traitement documenté des frais.

13. Liquidité : financer ne signifie pas gagner

Un financeur apporte 50 000 dans une position de sortie du gestionnaire : débit OP.102 50 000, crédit OP.301 50 000. Le financement est suivi par propriétaire et nature. Il ne crédite ni un marchand au hasard ni les revenus.

Un rééquilibrage entre deux comptes du même périmètre est un transfert d’actif : débit position destination, crédit position source, avec transit si nécessaire. Il ne crée pas une nouvelle collecte. Un mouvement entre entités exige aussi les créances/dettes correspondantes dans leurs livres respectifs.

Droit disponible et liquidité disponible sont deux contrôles différents. Un marchand peut avoir un droit valide mais le circuit être temporairement non financé. Le système bloque ou met en attente la sortie ; il ne retire pas fictivement le droit et ne donne pas un succès imaginaire.

PI-SPI réduit les connexions nécessaires aux institutions couvertes. Il ne dispense pas le participant de disposer de ressources de règlement et ne prouve pas qu’un wallet Kelyko par opérateur est nécessaire. Fonds suffisants sur le compte source.

14. Échecs, inconnus et retours

Un HTTP 200 peut seulement signifier accepté et réservé, avec pending. Le succès arrive ensuite par événement ou consultation. Asynchronisme des transferts.

La libération des frais suit ce qui a réellement été consommé et les règles applicables ; le cas sans débit ne justifie pas une restitution automatique si un frais distinct demeure dû. Une issue inconnue n’est jamais traitée comme un échec par simple dépassement de délai.

15. Remboursements et contestations

Un remboursement est une opération distincte, reliée au paiement initial. Il a ses droits, son montant, ses frais éventuels, sa réservation et sa preuve de dénouement. Le paiement initial reste dans le journal.

Exemple autonome : droit marchand disponible 9 850 ; remboursement client demandé 5 000, sans frais nouveaux dans cet exemple. Réservation : débit OP.202 5 000 / crédit OP.203 5 000. Après exécution confirmée : débit OP.203 5 000 / crédit OP.102 5 000. Il reste 4 850 de droit marchand ; les 150 de frais d’entrée restent identifiés tant que leur restitution n’est pas effectivement due et enregistrée.

Pour un remboursement brut de 10 000 après une collecte nette de 9 850, il manque 150 si les frais d’entrée ne sont pas restitués. Le système doit exiger un financement autorisé, une créance fondée ou une prise en charge explicitement décidée. Il ne crée pas un disponible positif fictif.

Une contestation carte peut entraîner une retenue, une reprise et un recours. Si 10 000 sont effectivement repris alors qu’il ne reste que 715 disponibles et que le recours de 9 285 contre le marchand est établi : débit OP.202 715, débit OP.104 9 285, crédit OP.102 10 000. Le disponible ne devient pas silencieusement négatif ; la créance de recours est visible. Cette écriture suppose aussi que la reprise soit financée dans le périmètre externe : les fonds des autres marchands ne deviennent pas la variable d’ajustement. Les frais de contestation sont enregistrés séparément. Retenues et contestations dans les CGU de référence.

16. Retenue de risque et fonds conditionnels : deux objets

Une retenue de risque reclasse un droit marchand déjà reconnu : débit OP.202 / crédit OP.204. Sa levée inverse ce classement. Elle ne réduit ni la position externe ni le total dû.

Le produit escrow de la documentation Jèko suit un pot conditionnel. Les fonds au statut held ne sont pas dans le solde marchand ni dans GET /transactions avant libération ; ce n’est pas un séquestre réglementé. Cycle et exclusions du solde.

Le registre complet doit donc suivre ces fonds dans un auxiliaire distinct. À confirmation d’un pot de 10 000 sans détail de frais acquis dans cet exemple : débit OP.102 10 000 / crédit OP.205 10 000. À la libération avec frais établis de 150 : débit OP.205 10 000 / crédits OP.202 9 850 et OP.210 150. Si les frais sont reconnus ou prélevés à une autre étape par le fournisseur, la chronologie suit cette preuve, sans second prélèvement.

Un refunded signalant le lancement d’un remboursement ne suffit pas à prouver que le payeur a effectivement récupéré les fonds. Le pot et son opération de remboursement doivent tous deux être rapprochés. Pour contrôler l’ensemble, solde marchand seul ≠ totalité des fonds conditionnels + droits marchands.

17. Multi-marchands, magasins et sorties par lots

La documentation SP crée un magasin dédié au marchand et une clé limitée à ce périmètre. Cela établit un besoin d’individualisation, pas un compte bancaire physique par magasin. Clés et magasins.

Chaque compte auxiliaire porte merchant_id et, si utile, store_id. Une sortie de A ne consomme jamais le droit de B. Une consolidation d’écran ne doit pas élargir les droits d’une clé ni rendre fongibles des patrimoines distincts.

Une sortie de A vers B, lorsque le dispositif l’autorise, débite le droit de A et crédite celui de B, en identifiant les frais. Le total des droits, hors frais, ne change pas : ce n’est pas une nouvelle collecte externe. Ne pas modéliser un simple rattachement de magasin comme un transfert d’argent.

Un lot de 100 instructions comporte 100 opérations avec références propres, réservations et résultats indépendants. Un lot partiellement réussi ne donne pas lieu à une reprise globale : seules les lignes définitivement non exécutées peuvent être libérées. Les lignes inconnues restent réservées. Le total du lot est un contrôle, pas une 101e sortie financière.

18. Le dossier de preuve de chaque franc

Le nom du réseau d’entrée et la destination de sortie sont conservés séparément. Les identifiants du registre sont notre conception ; txId, endToEndId et les références de transfert correspondent aux documentations respectives. Paiement PI-SPI, événements fournisseur.

19. Les contrôles automatiques et les rapprochements

1. Pour chaque journal et devise : somme des débits = somme des crédits.
2. Pour chaque marchand : droit net dû = attente + disponible + réservé + retenu ; aucun compartiment négatif non prévu.
3. Pour chaque sortie : montant envoyé + frais = débit total réservé ; une réservation n’est consommée qu’une fois.
4. Pour chaque événement financier unique : un seul effet économique. Un doublon technique est conservé comme preuve, pas réappliqué.
5. Pour chaque position : ouverture + mouvements prouvés = clôture, avec décalages et écarts explicités.
6. Pour chaque commande : rapprocher le montant attendu, les paiements réellement reçus et la résolution de tout surpaiement.
7. Pour chaque transfert : rapprocher instruction, débit source, résultat destinataire et retour éventuel.
8. Pour chaque tarif : rapprocher montant facturé, prélèvement externe, partage et règlement de la commission.
9. Pour les fonds conditionnels : rapprocher les pots et opérations dédiées, pas seulement l’API de transactions marchandes.
10. Pour le gestionnaire habilité : rapprocher obligations clients et protection selon son régime ; le livre de Kelyko ne certifie pas seul cette couverture.

La partie double détecte un déséquilibre interne ; elle ne détecte pas à elle seule un paiement externe inventé mais comptabilisé de façon équilibrée. Le rapprochement relie intention commerciale, événement financier et relevé du gestionnaire.

Un écart reçoit un dossier : montant, compte, références, date de première détection, cause, propriétaire de résolution, justificatifs et décision. Une différence inexpliquée n’est pas automatiquement passée en perte ni en revenu pour « faire coller » les soldes.

20. Les règles de réalisation pour l’équipe

Le journal est append-only : correction par contre-écriture et nouvelle écriture, jamais effacement d’un mouvement confirmé. La réservation est atomique avec le contrôle du disponible et une clé d’idempotence. Les appels réseau ne restent pas dans une transaction de base verrouillée : une instruction durable et un mécanisme d’envoi/reprise relient la base à l’extérieur.

Les tables minimales sont : comptes de contrôle, journaux, lignes débit/crédit, événements externes reçus, liens événement-journal, instructions d’envoi, paiements/tentatives, réservations, bénéficiaires, références de relevé, rapprochements/écarts, tarifs versionnés et habilitations.

Le résultat est appliqué seulement après authentification du message et vérification de la référence, du montant, de la devise et du périmètre. Les événements tardifs et contradictoires sont traités selon leur preuve, pas selon leur seul ordre d’arrivée. Une consultation de statut complète les notifications manquantes. Webhooks et événements.

Une lecture de solde suivie d’une écriture sans protection transactionnelle permet deux sorties concurrentes sur le même disponible : le contrôle doit être effectué dans la réservation elle-même. Les exports comptables restent rattachés au journal d’origine et à leur période ; une contre-écriture tardive ne réécrit pas rétroactivement la clôture.

Les données de bénéficiaires, justificatifs et secrets restent protégées. Le support pédagogique ne présente que des identifiants fictifs. Aucun exemple ne contient une clé permettant d’exécuter une opération.

21. Ce que voient les utilisateurs

Marchand : brut encaissé, frais, net, quatre compartiments, demandes de reversement, montant reçu, frais de sortie et références. Une alerte explique un délai ou une retenue sans faire disparaître le droit.

Opérations : mouvements par marchand, partenaire et circuit, réservations anciennes, transit, résultats inconnus, écarts et dossiers à résoudre. Les actions financières sont habilitées et journalisées.

Finance : positions externes, droits et fonds conditionnels, commissions, avances, rapprochements de relevés et export par entité. Le financement propre, les fonds des marchands et la rémunération restent identifiables.

Développeur : événements, identifiants de corrélation, version des schémas, réponses et rejets techniques ; cet accès ne donne pas automatiquement le droit d’approuver une sortie ou de corriger un solde.

22. Ce qui est fixé et ce qui doit être renseigné

Le plan de comptes de contrôle, les équilibres, la conservation des preuves, les quatre compartiments et les règles de réservation peuvent être définis et testés maintenant. Ce ne sont pas des attentes vagues : ce sont des exigences de réalisation.

Les variables externes sont les titulaires et identifiants des comptes, leur gestionnaire, la disponibilité par circuit, le financement, le partage des frais, les taxes et les délais contractuels. Elles alimentent le référentiel ; leur absence ne justifie pas de les remplacer par les informations privées présumées d’un concurrent.

Une API publique explique le contrat technique exposé et certains effets financiers. Les CGU donnent des engagements publics. Elles ne sont pas le contrat signé par Kelyko, ni le plan de comptes interne complet d’une banque. Nous déduisons les fonctions nécessaires et leurs contreparties ; nous ne prétendons pas connaître les numéros ou conventions non publiés.

23. Sources et méthode

Recherche approfondie demandée à Perplexity, contrôles directs Firecrawl de CGU, guides Jèko, documents BCEAO et portail API PI-SPI. Les captures, résultats et bilan sont conservés dans docs/sources-tracabilite/. Les sources sont utilisées pour leurs mécanismes et règles ; les écritures OP sont notre synthèse de conception, vérifiée sur les scénarios.

Le document MinerU joint est un extrait de conversation : ses déclarations de partenaires sont attribuées au fondateur ; les recommandations de l’ancien assistant ne deviennent pas des décisions validées. Ses images distantes ne sont pas nécessaires aux nouvelles infographies. L’original est conservé hors Git, sans exécuter ses commandes.

Les liens de sources sont placés auprès des affirmations. Les pages PI-SPI qui ne retournent qu’une coquille de navigation sont signalées comme non probantes dans le bilan de collecte. Aucun paiement réel, compte financier ou API privée n’a été manipulé dans cette étude.