Orange Money a procédé à une mise à jour de l’architecture technique de ses API. Cette évolution est imposée par Orange Money à l’ensemble des agrégateurs et de leurs marchands : elle impacte directement toutes les intégrations existantes (encaissement comme remboursement) et nécessite des ajustements côté partenaires et clients avant la date limite fixée par l’opérateur (qui vous est communiqué par mail).
Concrètement, cette migration change les identifiants d’accès (customerkey / customersecret et clientID / clienSecret) ainsi que certains endpoints utilisés pour la génération du token, l’encaissement, le remboursement et la vérification de statut de vos transactions Orange Money.
La bonne nouvelle : cette contrainte apporte aussi de vrais bénéfices.
- Suivi en temps réel : vos transactions Orange Money (paiements comme remboursements) deviennent visibles et suivables en temps réel directement depuis votre interface MI, sans dépendre du délai de mise à jour de la plateforme de reporting d’Orange (habituellement décalé de 4h). Vous gagnez ainsi en réactivité pour le suivi de votre trésorerie et le traitement de vos demandes de remboursement
- Une intégration simplifiée : la nouvelle API Paynote réduit le nombre de requêtes nécessaires pour initier un paiement, ce qui allège votre code et réduit les risques d’erreur d’intégration.
- Une API uniformisée : vos intégrations Orange Money suivent désormais la même logique que vos autres moyens de paiement Paynote (MTN MoMo, M2U UBA, etc.). Un seul modèle d’intégration à maintenir, quel que soit l’opérateur.
Cet article vous présente les nouvelles configurations à adopter, les étapes de migration, ainsi que la procédure de réinitialisation de vos accès API si vous ne l’avez pas encore fait.
Nouvelle requête API de Remboursement Orange Money (Cash-out)
Étape 1 – Récupération du token
URL : https://omapi-token.ynote.africa/oauth2/token
Étape 2 – Initiation du paiement
URL : https://omapi.ynote.africa/prod/webpayment
Corps de la requête (JSON) :
2
3
4
5
6
7
8
9
"customerkey":"nouvelle clés envoyé par Ynote",
"customersecret":"nouvelle clés envoyé par Ynote",
"webhook":"https://webhook.site/ad5cba2f-bace-4356-8f73-dd5c3f5c164a",
"amount":"1000",
"final_customer_phone":"692xxx",
"final_customer_name": "",
"refund_method":"OM_CMR"
}
Étape 3 – Vérification du statut du paiement
URL :https://omapi.ynote.africa/prod/refund/status/message_id/
Corps de la requête (JSON) :
2
3
4
5
"customerkey":"nouvelle clés envoyé par Ynote",
"customersecret":"nouvelle clés envoyé par Ynote",
"refund_method": "OM_CMR"
}
Ancienne requête API de Remboursement Orange Money (cash-in)
Étape 1 – Récupération du token
l’URLhttps://omapi-token.ynote.africa/oauth2/token
Étape 2 – Initiation du paiement
l’URL: https://omapi.ynote.africa/prod/webpayment
Corps de la requête (JSON) :
2
3
4
5
6
7
8
9
10
11
"customerkey":"xxx",
"customersecret":"xxx",
"webhook":"https://webhook.site/1b47510c-4948-45f8-8ea3-f06b679ca734",
"amount":"100",
"pin": "xx",
"final_customer_phone":"6933xx",
"channelUserMsisdn": "6964xx",
"final_customer_name":"xx",
"refund_method":"OrangeMoney"
}
Étape 3 –statut du remboursement
l’URL: https://omapi.ynote.africa/prod/refund/status/3cd4270e-6bf7-4939-9998-76f420527087
Corps de la requête (JSON) :
2
3
4
"customerkey":"xxx",
"customersecret":"xxx"
}
