Changelog API

Bascule sur le contrat Orange Money « AskPayment » V2

L'intégration opérateur passe de l'API WebPay (page de paiement hébergée + OAuth) au contrat d'interface AskPayment d'Orange Finances Mobiles Mali : le client confirme désormais son paiement par push USSD sur son téléphone. Détail de l'intégration →

Ajouts

• Champ de requête motif sur POST /payments/cashin — texte affiché au client dans le push USSD
• Champs de réponse payment_method, provider_reference, provider_session_id, provider_state, provider_txn_status
• Page de suivi de confirmation /payment/pending/{ref} et statut public /payment/status/{ref}
• Endpoint de notification opérateur GET /api/webhooks/orange/notification (§2.3 du contrat)
• failure_reason enrichi de la table de codes Orange (solde insuffisant, code secret incorrect, seuils client)

Changements de comportement

• payment_url pointe désormais vers la page de suivi Neka Paie, et non vers une page de paiement Orange : le paiement se confirme sur le téléphone du client.
• provider_tx_id reste null jusqu'à la confirmation du client — le rapprochement pendant l'attente se fait sur provider_reference.
• POST /payments/cashout répond 501 : le décaissement n'est pas couvert par le contrat AskPayment V2.
• L'ancien webhook POST /api/webhooks/orange/{country_code} est remplacé par l'endpoint de notification ci-dessus.

Notes

• Aucun changement sur l'authentification HMAC ni sur le format des webhooks marchands.
• Les transactions antérieures à la bascule conservent leurs données WebPay pour l'audit.

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

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)

Ajouts

• Première version privée pour les partenaires fondateurs
• Endpoint Cash-In de base
• Webhook simple sans retry policy

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