API de type REST
JSON sur HTTPS pour la consultation du catalogue, la passation de commandes et la récupération de statut, authentifié par des identifiants par partenaire délivrés via un canal sécurisé.
Développeurs
JubilePay propose une API documentée pour les plateformes et intégrateurs. La documentation et les identifiants sont remis aux partenaires dans le cadre d’un accord ; cette page présente les options d’intégration et la façon de demander un accès.
Modalités d’accès
| Documentation de l’API | Remise aux partenaires sous accord |
|---|---|
| Environnement de test | Fourni lors de l’intégration technique |
| Accès en production | Délivré après les vérifications de mise en service |
| Accès géré (sans API) | Voir Distribution gérée |
Documentation
La documentation de l’API est partagée avec les partenaires dans le cadre d’un accord. Demandez un accès via le formulaire de contact.
Options d’intégration
Webhooks
Notifications de statut poussées vers une URL que vous enregistrez, pour éviter à votre système d’interroger en boucle.
Outils gérés
Pour les partenaires qui ne souhaitent pas intégrer : commande via des outils gérés dans le cadre du produit Distribution professionnelle.
Principes de conception
- Des requêtes de commande idempotentes afin que les nouvelles tentatives ne dupliquent jamais une livraison.
- Des valeurs de statut explicites et documentées pour chaque commande.
- Un environnement de test au comportement identique à la production, avec des données de test clairement marquées.
- Des identifiants jamais envoyés par courriel ; rotation prise en charge dès le premier jour.
- Une API versionnée avec une politique de dépréciation publiée.
Forme illustrative d’une requête de commande
À titre illustratif uniquement — ce n’est pas un point d’accès réelL’exemple ci-dessous montre le type de requête et de réponse en cours de conception. Il est purement illustratif : l’hôte, les chemins, les champs et les valeurs ne sont pas réels et changeront. Ne développez pas à partir de cet exemple.
POST /v0/orders (illustratif)
Host: api.example.invalid
Authorization: Bearer <partner-token>
Idempotency-Key: 7f1c…
Content-Type: application/json
{
"product_id": "example-airtime-product",
"recipient": { "msisdn": "+000000000000" },
"amount": { "value": "5.00", "currency": "XXX" },
"reference": "your-order-ref-123"
}HTTP/1.1 202 Accepted (illustratif)
Content-Type: application/json
{
"order_id": "ord_example",
"status": "processing",
"reference": "your-order-ref-123"
}POST https://partner.example.invalid/webhooks/jubilepay (illustrative)
Content-Type: application/json
X-Signature: sha256=…
{
"event": "order.completed",
"order_id": "ord_example",
"status": "completed",
"reference": "your-order-ref-123",
"occurred_at": "2026-01-01T00:00:00Z"
}Manifester un intérêt d’intégration
Parlez-nous de votre plateforme, des produits que vous souhaitez proposer et de vos marchés. Choisissez « API ou intégration technique » dans le formulaire de contact.