Changelog API
Historique des évolutions de l'API Neka Paie. Compatibilité ascendante garantie sur 24 mois.
v1.0.0 — 29 avril 2026 Stable
Version actuelleAjouts
- Endpoint
POST /api/v1/payments/cashinavec idempotence surmerchant_order_id - Endpoint
POST /api/v1/payments/cashoutavec validation à deux yeux configurable - Endpoint
GET /api/v1/payments/{id}pour le polling de statut - Endpoint
POST /api/v1/refundstotal ou partiel - Endpoint
GET /api/v1/balancespar filiale - Endpoint
GET /api/v1/transactions/exportau format JSON ou CSV - Réception webhooks Orange sur
POST /api/webhooks/orange/{country_code} - Authentification HMAC-SHA256 avec anti-replay 300s
- Webhooks signés vers les marchands (6 retries sur 24h)
- Filiale Mali (ML) active
- Inscription développeur self-service avec sandbox immédiat
Notes
- Premier release stable — compatibilité v1 garantie jusqu'au 29 avril 2028
- Les autres filiales (CI, SN, BF, BJ, TG, NE, CM, CD) seront activées progressivement sans rupture API
v0.9.0 — 15 avril 2026 Beta
Ajouts
- Mode sandbox accessible sans KYC
- Support des metadata libres dans les transactions
- MSISDN de test prédéfinis pour forcer un comportement
Modifications
- Renommage
X-API-Key→X-NekaPay-Key(idem Signature, Timestamp) - Format des montants : passage en plus petite unité (centime XOF au lieu de XOF)
v0.5.0 — 1er avril 2026 Alpha
Ajouts
- Première version privée pour les partenaires fondateurs
- Endpoint Cash-In de base
- Webhook simple sans retry policy
Roadmap publique
Q3 2026 (v1.1)
- Activation Côte d'Ivoire et Sénégal
- SDK officiels packagés (Composer, npm, PyPI)
- Endpoint
POST /payments/recurringpour les abonnements - Webhook simulator depuis le dashboard
Q4 2026 (v1.2)
- Activation Burkina Faso, Bénin, Togo, Niger
- Multi-devises (conversion XOF ↔ USD/EUR)
- API de réconciliation push (Kafka stream)
Q1 2027 (v2.0)
- Ajout MTN MoMo et Wave en multi-opérateurs
- OAuth 2.0 pour les marchands (en complément du HMAC)
- GraphQL endpoint pour les requêtes complexes
Politique de versioning
- Versioning par préfixe d'URL :
/api/v1,/api/v2, etc. - Compatibilité ascendante : les versions majeures restent supportées 24 mois minimum.
- Annonces de breaking changes : notifiées 90 jours avant via email + dashboard.
- Sunset : header
Sunsetindiquant la date de retrait pour les endpoints dépréciés. - Statut de l'API : suivi en temps réel sur
https://status.nekapaie.com(à venir).
S'abonner aux notifications de changement : contact@nekapaie.com