Changelog API

Production
Changelog API
Historique des évolutions de l'API Neka Paie. Compatibilité ascendante garantie sur 24 mois.

v1.0.0 — 29 avril 2026 Stable

Version actuelle
Ajouts
  • Endpoint POST /api/v1/payments/cashin avec idempotence sur merchant_order_id
  • Endpoint POST /api/v1/payments/cashout avec validation à deux yeux configurable
  • Endpoint GET /api/v1/payments/{id} pour le polling de statut
  • Endpoint POST /api/v1/refunds total ou partiel
  • Endpoint GET /api/v1/balances par filiale
  • Endpoint GET /api/v1/transactions/export au 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-KeyX-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/recurring pour 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 Sunset indiquant 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