> ## Documentation Index
> Fetch the complete documentation index at: https://docs.umeme.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Comment marche Umeme

> Umeme vend de l'électricité prépayée et des abonnements TV pour le compte de revendeurs, depuis un portefeuille prépayé. Voici les pièces, et comment elles s'enchaînent.

## Trois comptes

Une vente porte toujours sur un compte. Le compte décide du fournisseur, du délai et de ce que reçoit votre client.

| Compte | Ce que vous vendez | Ce que reçoit le client |
| :- | :- | :- |
| `SOCODE` | Électricité prépayée ; environ 4 s en production | Un jeton à 20 chiffres et un reçu PDF |
| `VIRUNGA` | Électricité prépayée, avec une confirmation plus longue ; environ 23 s | Un jeton et un reçu PDF |
| `TV` | Le renouvellement d'un abonnement TV | Un reçu PDF ; l'abonnement est prolongé |

## Le portefeuille prépayé

Chaque intégrateur est rattaché à un revendeur, qui porte le portefeuille. Une vente acceptée le débite ; une vente échouée le rembourse aussitôt. Vous le rechargez auprès d'Umeme, et vous le suivez avec [Recharger et suivre son portefeuille](https://docs.umeme.app/guides/portefeuille.md).

> [!TIP]
>
> Dans la sandbox, le portefeuille part de `1 000 $` fictifs, et se recharge jusqu'à `5 000 $`.

## Le parcours d'une vente

**1. Vous soumettez la vente**

`POST /v1/ventes`, avec un `uuid` que vous avez généré. La réponse arrive tout de suite : `ACCEPTEE`, `REJETEE` ou `DOUBLON_IGNORE`.

**2. Umeme vend chez le fournisseur**

La vente est `EN_COURS`. Si la réponse du fournisseur se perd, Umeme vérifie : la vente est alors `EN_RECONCILIATION`.

**3. L'issue tombe**

`REUSSIE`, avec le jeton et le reçu ; ou `ECHOUEE`, et le portefeuille est déjà remboursé.

**4. Umeme vous rappelle**

Un `POST` signé à votre URL de rappel, avec le même corps que la consultation de la vente.

**5. Et voilà !**

Vous savez comment une vente traverse Umeme.

## Jeton et reçu

Le client saisit le jeton sur son compteur. Le reçu PDF reprend le jeton, le compteur et le montant ; dans la sandbox, il porte le filigrane « SPÉCIMEN ». Si vous donnez `telClient`, le client reçoit aussi le jeton par SMS.

## Et ensuite ?

> [card] [À savoir](https://docs.umeme.app/a-savoir.md)
>
> Les six règles à connaître avant d'écrire du code.

> [card] [Démarrer](https://docs.umeme.app/demarrer.md)
>
> Votre clé, votre premier appel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.