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.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.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.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 donneztelClient, le client reçoit aussi le jeton par SMS.
Et ensuite ?
À savoir
Les six règles à connaître avant d’écrire du code.
Démarrer
Votre clé, votre premier appel.