Skip to main content
POST
/
airtime
cURL
curl --request POST \
  --url http://proxy-airtime.easytransfert.app/api_v1/transaction/airtime \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123,
  "api_key": "<string>",
  "destination": "<string>",
  "ipn_url": "<string>",
  "service_id": 123,
  "custom_data": "<string>",
  "om_otp": "<string>"
}
'
{
  "error": "<string>"
}
Cette page documente l’opération d’initiation de transaction (cashout / cashin). Description:
  • Endpoint: POST /airtime (base URL défini dans la collection Postman)
  • Utilisation: initie une transaction et déclenche une IPN (callback) pour la confirmation finale.
Exemple de requête (JSON): 
{
  "amount": 1000,
  "api_key": "votre_cle_api",
  "destination": "0670123456",
  "service_id": 10,
  "ipn_url": "https://votre-site.com/webhook/easytransfert",
  "custom_data": "" 
}
Notes:
  • service_id identifie le fournisseur (MTN, Orange, etc.) et le type d’opération.
  • La réponse immédiate confirme la réception; la confirmation finale arrive via l’IPN.
Vous trouverez la liste des services dans la documentation

Body

application/json
​
amount
integer
required

Montant de la transaction (doit être un multiple de 100)

Example:

500

​
api_key
string
required

Votre clé d'API

Example:

"xxxxxxxxxxxxxxxxxxx"

​
destination
string
required

Numéro de téléphone du payeur (pour le paiement) numéro du recepteur (pour le transfert sans l'indicatif (225)

Example:

"0103444777"

​
ipn_url
string
required

Url de notification. Sur cette url vous recevrez les statuts des opérations de cashin ou cashout

Example:

"https://webhook.site/6da1dcfa-4cb2-4fb9-991a-8a841e246803"

​
service_id
integer
required

Le numéro du service que vous souhaitez consommer

Example:

12

​
custom_data
string

Il s'agit de données que vous souhaitez envoyer en plus dans la requette. cette données vous sera retourné dans l'IPN

​
om_otp
string

À utiliser uniquement avec les service_id 27,29 et 23 cashout orange money. Il s'agit du code d'autorisation du débit obtenu par le client en composant #144*82# (pour la cote d'ivoire) ou le #144#391# (pour orange sénégal). La donnée doit être envoyée en chaine de caractère. Exemple otp: 1234 ==> om_otp: "1234"

Response

Transaction échouée (refus client, solde insuffisant, etc.)

​
error
string

Message d'erreur

Example:

"Transaction failed due to insufficient funds"