Orange Money — Mali

Identité

Champ	Valeur
Pays	Mali
Opérateur	Orange Money Mali
`operator_id`	`18`
`operator_name`	`ORANGE MALI`
Indicatif	+223
Format du numéro	`223XXXXXXXX` (sans `+` ni espaces)
Endpoint	`POST /pay/v01/straight/checkout-invoice/create`
Mode de validation	Redirection opérateur

Mode de validation : Redirection opérateur

Pour Orange Money Mali, l’intégration LigdiCash passe par le portail web d’Orange Money pour authentifier le client. Le flux est le suivant :

Vous appelez /pay/v01/straight/checkout-invoice/create avec le numéro du client.
LigdiCash répond avec le token de transaction et un champ response_text qui contient l’URL du portail Orange Money (https://mpayment.orange-money.com/ml/...).
Vous redirigez le navigateur du client vers cette URL.
Le client s’authentifie et confirme le paiement sur le portail Orange.
LigdiCash vous notifie le résultat final via votre callback_url.

Le retour navigateur du client après le portail Orange n’est pas garanti — l’utilisateur peut fermer l’onglet, perdre le réseau, ou ne jamais revenir. Le callback reste la seule source de vérité. Ne validez jamais le paiement uniquement sur le retour du client.

Ce mode utilise bien l’endpoint /straight/checkout-invoice/create (payin sans redirection), mais le parcours utilisateur inclut une redirection externe vers le portail de l’opérateur. Ne pas confondre avec le payin avec redirection, qui utilise l’endpoint /redirect/checkout-invoice/create et expose la page de paiement LigdiCash.

UX recommandée

Collecter le numéro du client

Votre formulaire recueille uniquement le numéro de téléphone Orange Money Mali.

Soumettre la requête

Requête avec le numéro dans customer et otp: "".

Récupérer l'URL du portail

Dans la réponse, le champ response_text contient l’URL du portail Orange Money (https://mpayment.orange-money.com/ml/...).

Rediriger le client

Redirigez le navigateur du client vers cette URL. Le client s’authentifie sur le portail Orange et confirme le paiement.

Attendre le callback

Le résultat final arrive via votre callback_url. Affichez un état d’attente jusqu’à réception du callback — ne vous fiez pas au retour navigateur.

Exemple de requête

curl -X POST https://app.ligdicash.com/pay/v01/straight/checkout-invoice/create \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "commande": {
      "invoice": {
        "items": [],
        "total_amount": 5000,
        "devise": "XOF",
        "description": "Abonnement Pro — Janvier 2025",
        "customer": "22370000000",
        "customer_firstname": "Ibrahim",
        "customer_lastname": "Traoré",
        "customer_email": "ibrahim@exemple.com",
        "external_id": "",
        "otp": ""
      },
      "store": {
        "name": "MonApp",
        "website_url": "https://monapp.com"
      },
      "actions": {
        "cancel_url": "",
        "return_url": "",
        "callback_url": "https://monapp.com/api/callback/ligdicash"
      },
      "custom_data": {
        "transaction_id": "ORD-2025-00062"
      }
    }
  }'

const response = await fetch(
  "https://app.ligdicash.com/pay/v01/straight/checkout-invoice/create",
  {
    method: "POST",
    headers: {
      Apikey: process.env.LIGDICASH_API_KEY,
      Authorization: `Bearer ${process.env.LIGDICASH_API_TOKEN}`,
      Accept: "application/json",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      commande: {
        invoice: {
          items: [],
          total_amount: 5000,
          devise: "XOF",
          description: "Abonnement Pro — Janvier 2025",
          customer: "22370000000",
          customer_firstname: "Ibrahim",
          customer_lastname: "Traoré",
          customer_email: "ibrahim@exemple.com",
          external_id: "",
          otp: "",
        },
        store: { name: "MonApp", website_url: "https://monapp.com" },
        actions: {
          cancel_url: "",
          return_url: "",
          callback_url: "https://monapp.com/api/callback/ligdicash",
        },
        custom_data: { transaction_id: "ORD-2025-00062" },
      },
    }),
  }
);

const data = await response.json();
// Redirigez le client vers le portail Orange
window.location.href = data.response_text;

$payload = [
  "commande" => [
    "invoice" => [
      "items" => [],
      "total_amount" => 5000,
      "devise" => "XOF",
      "description" => "Abonnement Pro — Janvier 2025",
      "customer" => "22370000000",
      "customer_firstname" => "Ibrahim",
      "customer_lastname" => "Traoré",
      "customer_email" => "ibrahim@exemple.com",
      "external_id" => "",
      "otp" => "",
    ],
    "store" => ["name" => "MonApp", "website_url" => "https://monapp.com"],
    "actions" => [
      "cancel_url" => "",
      "return_url" => "",
      "callback_url" => "https://monapp.com/api/callback/ligdicash",
    ],
    "custom_data" => ["transaction_id" => "ORD-2025-00062"],
  ],
];

$ch = curl_init("https://app.ligdicash.com/pay/v01/straight/checkout-invoice/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Apikey: " . $_ENV["LIGDICASH_API_KEY"],
  "Authorization: Bearer " . $_ENV["LIGDICASH_API_TOKEN"],
  "Accept: application/json",
  "Content-Type: application/json",
]);

$data = json_decode(curl_exec($ch), true);
// Redirigez le client vers le portail Orange
header("Location: " . $data["response_text"]);

Réponse attendue

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "response_text": "https://mpayment.orange-money.com/ml/mpayment/abstract/v1nd8lrkjniiezp3gus76kvmlgztvuylkcs2y5kiir6stko13emvuabrv95oaufb",
  "description": "",
  "custom_data": {
    "transaction_id": "ORD-2025-00062",
    "logfile": "202605111744086a021568f2037"
  },
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

{
  "response_code": "01",
  "token": "",
  "response_text": "Echec (Code00)",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

Stockez le token immédiatement après la création. Utilisez-le pour appeler confirm à la réception du callback — ne vous fiez pas au token présent dans le payload du callback.

Limites

Paramètre	Valeur
Montant minimum	100 XOF
Montant maximum	—
Limite quotidienne	—

Pages associées

Modes de validation — Redirection opérateur — détail du flux
Créer une transaction — référence complète de l’endpoint
Vérifier le statut — appeler confirm après le callback

Démarrage

Concepts fondamentaux

API de paiement

Guides pratiques

Gestion des erreurs

SDK & Plugins

Autres produits

Outils IA

Ressources

Orange Money — Mali

Identité

Mode de validation : Redirection opérateur

UX recommandée

Exemple de requête

Réponse attendue

Limites

Pages associées

​Identité

​Mode de validation : Redirection opérateur

​UX recommandée

​Exemple de requête

​Réponse attendue

​Limites

​Pages associées

Identité

Mode de validation : Redirection opérateur

UX recommandée

Exemple de requête

Réponse attendue

Limites

Pages associées