Endpoint
POST {{base_url}}/airtime
Authentification
L’authentification se fait via la clé API transmise dans le corps de la requête. Il n’y a pas de header Authorization.
Paramètres de la requête
| Champ | Type | Obligatoire | Description |
|---|
amount | int | Oui | Montant de la transaction en FCFA. Doit être un multiple de 100 (ex: 500, 1000, 1500). |
api_key | string | Oui | Clé API EASYTRANSFERT pour authentification |
destination | string | Oui | Numéro mobile du bénéficiaire sans indicatif international (ex: 0103444777, pas +2250103444777) |
service_id | int | Oui | Identifiant du service (Cashin ou Cashout selon l’opérateur) |
ipn_url | string | Oui | URL de callback pour recevoir les notifications IPN |
custom_data | string | Non | Référence interne qui sera retournée dans l’IPN |
om_otp | string | Conditionnel | Uniquement pour Orange Money Cashout (service_id 23, 27, 29). Code d’autorisation obtenu par le client via #144*82# (CI) ou #144#391# (SN). |
Exemple – MTN Cashout
{
"amount": 5000,
"api_key": "xxxxxxxxxxxxxxx",
"destination": "0503444777",
"service_id": 25,
"ipn_url": "https://votre_webhook.url",
"custom_data": "order_789"
}
| Pays | Opérateur | Syntaxe | Note |
|---|
| Côte d’Ivoire | Orange | #144*82# | Payment by otp code |
| Moov | NO | A composer apres réception du sms de debit |
| Mtn CI | *133# | Confirmation by secret code after receiving the push sms |
| Wave | NO | Confirmation par QR Code |
| Senegal | Orange | #144#391# | Payment by otp code |
| Expresso | *444*3*3# | A composer apres réception du sms de debit |
| Free | NO | Confirmation by secret code after receiving the push sms |
| Wave | NO | Confirmation par QR Code |
| Mali | Orange | #144#77# | Payment by otp code |
| Moov | NO | Confirmation by secret code after receiving the push sms |
| Togo | Tmoney | NO | Confirmation by secret code after receiving the push sms |
| Flooz | NO | Confirmation by secret code after receiving the push sms |
| Benin | Moov | *855*7*8# | Confirmation by secret code after receiving the push sms |
| Mtn | NO | Confirmation by secret code after receiving the push sms |
| Burkina Faso | Orange | *144*4_*6_*100# | Payment by otp code |
| Moov | *555*6# | Confirmation by secret code after receiving the push sms |
| Cameroun | Orange | #150*50# | Confirmation by secret code after receiving the push sms |
| Mtn | *126# | Confirmation by secret code after receiving the push sms |
| Express Union | NO | Confirmation from the app |
| RD Congo | Orange CD | NO | Confirmation by secret code after receiving the push sms |
| MPesa CD | NO | Confirmation by secret code after receiving the push sms |
| Airtel CD | NO | Confirmation by secret code after receiving the push sms |
| Orange CDUSD | NO | Confirmation by secret code after receiving the push sms |
| Mpesa CDUSD | NO | Confirmation by secret code after receiving the push sms |
| Guinée | Orange | #144#, Choice option 4 and l’option 2 | Payment by otp code |
| Mtn | NO | Confirmation by secret code after receiving the push sms |
Exemple – Orange CI Cashout avec OTP
Pour les transactions où le paramètre om_otp est requis :
{
"amount": 5000,
"api_key": "xxxxxxxxxxxxxxx",
"destination": "0701234567",
"service_id": 27,
"ipn_url": "https://votre_webhook.url",
"custom_data": "order_789",
"om_otp": "1234"
}
Réponse immédiate
La réponse reçue ne confirme pas le succès final, elle indique seulement que la requête est valide.
{
"data": {
"transaction_id": "EFB.001158",
"amount": 12250,
"state": "PENDING1",
....
}
}
