Étape 2 - Initier une transaction

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 KAYBIC AFRICA 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"
}

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

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	4443*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	8557*8#	Confirmation by secret code after receiving the push sms
	Mtn	NO	Confirmation by secret code after receiving the push sms
Burkina Faso	Orange	1444_6_100#	Payment by otp code
	Moov	5556#	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.

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

INTRODUCTION

DÉMARRAGE RAPIDE

AUTHENTIFICATION & SÉCURITÉ

GESTION DES ERREURS

LIMITATIONS & RÈGLES MÉTIER

KAYBIC AFRICA Payment SDK

ANNEXES

Étape 2 - Initier une transaction

Endpoint

Authentification

Paramètres de la requête

Exemple – MTN Cashout

Exemple – Orange CI Cashout avec OTP

Réponse immédiate

​Endpoint

​Authentification

​Paramètres de la requête

​Exemple – MTN Cashout

​Exemple – Orange CI Cashout avec OTP

​Réponse immédiate

Endpoint

Authentification

Paramètres de la requête

Exemple – MTN Cashout

Exemple – Orange CI Cashout avec OTP

Réponse immédiate