| Terme | Définition |
|---|---|
| Intégrateur | Organisation (opérateur mobile money, plateforme de revendeurs, banque) qui vend par l’API depuis le portefeuille du revendeur auquel elle est rattachée. |
| Revendeur | Le compte qui porte le portefeuille, les ventes et les commissions. L’intégrateur s’en sert ; il ne le remplace pas. |
| Portefeuille | Le solde prépayé du revendeur, qui finance les ventes. Une recharge l’alimente ; une vente le débite, quel que soit le compte vendu. |
| Clé d’API | Secret qui identifie l’intégrateur : umeme_test_ dans la sandbox, umeme_live_ en production. Montrée une seule fois ; dix au plus sont actives par intégrateur. |
| Compte | SOCODE, VIRUNGA ou TV : ce que l’on vend, et chez quel fournisseur. |
| Jeton | Code à 20 chiffres que le client saisit sur son compteur. |
| Reçu | PDF qui prouve la vente, avec son numéro. |
| uuid | Identifiant que vous donnez à chaque vente ; il la rend idempotente. |
| Statut | Où en est une vente : ACCEPTEE, REJETEE ou DOUBLON_IGNORE à la soumission, puis EN_COURS, EN_RECONCILIATION, REUSSIE ou ECHOUEE. |
| Rappel | POST signé qu’Umeme envoie à votre URL de rappel quand une vente atteint son statut final. |
| Réconciliation | Vérification par Umeme d’une vente dont la réponse du fournisseur s’est perdue, sans la vendre une seconde fois. |
| Sandbox | Environnement séparé de la production, sur sandbox.umeme.app : fournisseurs simulés, portefeuille fictif, aucune vente réelle. |
| Compteur de test | Compteur à 11 chiffres qui commence par 099000000, dont les deux derniers chiffres choisissent l’issue d’une vente dans la sandbox. |
Ressources
Glossaire
Les mots de l’API, tels qu’ils sont employés partout dans cette documentation.