curl -X POST "$UMEME_BASE_URL/ventes" \
-H "Authorization: Bearer $UMEME_CLE" \
-H "Content-Type: application/json" \
-d '{
"uuid": "94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb",
"compte": "SOCODE",
"reference": "09900000000",
"montant": 5
}'{
"uuid": "94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb",
"statut": "ACCEPTEE",
"creeLe": "2026-11-07T08:26:44Z"
}Créer une vente
Soumet une vente SOCODE, VIRUNGA ou TV. La réponse dit seulement si la vente est prise ; son issue arrive par le rappel, ou par GET /v1/ventes/{uuid}.
Un refus métier répond HTTP 200 avec REJETEE. Un HTTP 5xx ou un délai dépassé n’est jamais un échec : renvoyez la même vente avec le même uuid.
Portée de la clé : ventes:ecrire.
curl -X POST "$UMEME_BASE_URL/ventes" \
-H "Authorization: Bearer $UMEME_CLE" \
-H "Content-Type: application/json" \
-d '{
"uuid": "94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb",
"compte": "SOCODE",
"reference": "09900000000",
"montant": 5
}'{
"uuid": "94a223fe-fb34-47f2-aaa5-b80c4bf8a8eb",
"statut": "ACCEPTEE",
"creeLe": "2026-11-07T08:26:44Z"
}Autorisations
Votre clé d'API : umeme_test_… dans la sandbox, umeme_live_… en production.
Corps
Identifiant que vous générez et enregistrez avant l'appel. Le même uuid avec la même vente rend DOUBLON_IGNORE ; avec une autre vente, une erreur 409 UUID_REUTILISE.
Ce que l'on vend, et chez quel fournisseur.
SOCODE, VIRUNGA, TV Compteur à 11 chiffres pour SOCODE et VIRUNGA, référence d'abonnement pour TV. Dans la sandbox, les compteurs de test choisissent l'issue.
En dollars, de 0,50 à 5 000, deux décimales au plus. Débité du portefeuille à l'acceptation, remboursé si la vente échoue.
0.5 <= x <= 5000Téléphone du client en RDC, au format 243…. Il reçoit le jeton par SMS.
^243[0-9]{9}$Vos propres données, rendues telles quelles par la consultation et le rappel.
Réponse
La demande est traitée : acceptée, rejetée ou reconnue comme doublon.
L'identifiant envoyé.
Ce qu'il advient de la demande. L'issue de la vente, elle, suit les statuts EN_COURS, EN_RECONCILIATION, REUSSIE ou ECHOUEE.
ACCEPTEE, REJETEE, DOUBLON_IGNORE Heure d'acceptation, en UTC.
Présent si la vente est REJETEE. Rien n'a été débité.
Show child attributes
Show child attributes