Skip to main content

Documentation Index

Fetch the complete documentation index at: https://apidoc-business.easytransfert.app/llms.txt

Use this file to discover all available pages before exploring further.

​
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

ChampTypeObligatoireDescription
amountintOuiMontant de la transaction en FCFA. Doit être un multiple de 100 (ex: 500, 1000, 1500).
api_keystringOuiClé API KAYBIC AFRICA pour authentification
destinationstringOuiNuméro mobile du bénéficiaire sans indicatif international (ex: 0103444777, pas +2250103444777)
service_idintOuiIdentifiant du service (Cashin ou Cashout selon l’opérateur)
ipn_urlstringOuiURL de callback pour recevoir les notifications IPN
custom_datastringNonRéférence interne qui sera retournée dans l’IPN
om_otpstringConditionnelUniquement 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"
}
Pour les cas qui demandent des confirmations avec des codes OTP, veuillez consulter le tableau ci-dessous pour connaître les syntaxes à composer par pays et par opérateur
PaysOpérateurSyntaxeNote
Côte d’IvoireOrange#144*82#Payment by otp code
MoovNOA composer apres réception du sms de debit
Mtn CI*133#Confirmation by secret code after receiving the push sms
WaveNOConfirmation par QR Code
SenegalOrange#144#391#Payment by otp code
Expresso*444*3*3#A composer apres réception du sms de debit
FreeNOConfirmation by secret code after receiving the push sms
WaveNOConfirmation par QR Code
MaliOrange#144#77#Payment by otp code
MoovNOConfirmation by secret code after receiving the push sms
TogoTmoneyNOConfirmation by secret code after receiving the push sms
FloozNOConfirmation by secret code after receiving the push sms
BeninMoov*855*7*8#Confirmation by secret code after receiving the push sms
MtnNOConfirmation by secret code after receiving the push sms
Burkina FasoOrange*144*4_*6_*100#Payment by otp code
Moov*555*6#Confirmation by secret code after receiving the push sms
CamerounOrange#150*50#Confirmation by secret code after receiving the push sms
Mtn*126#Confirmation by secret code after receiving the push sms
Express UnionNOConfirmation from the app
RD CongoOrange CDNOConfirmation by secret code after receiving the push sms
MPesa CDNOConfirmation by secret code after receiving the push sms
Airtel CDNOConfirmation by secret code after receiving the push sms
Orange CDUSDNOConfirmation by secret code after receiving the push sms
Mpesa CDUSDNOConfirmation by secret code after receiving the push sms
GuinéeOrange#144#, Choice option 4 and l’option 2Payment by otp code
MtnNOConfirmation 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.
Exemple de réponse : 
{
  "data": {
    "transaction_id": "EFB.001158",
	"amount": 12250,
  	"state": "PENDING1",
	....
  }
}
La réponse complète peut être consultée dans la section API Reference