Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://developers.ligdicash.com/llms.txt

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

Identité

ChampValeur
PaysCôte d’Ivoire
OpérateurOrange Money Côte d’Ivoire
operator_id16
operator_nameORANGE CI
Indicatif+225
Format du numéro225XXXXXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationRedirection opérateur

Mode de validation : Redirection opérateur

Pour Orange Money Côte d’Ivoire, l’intégration LigdiCash passe par le portail web d’Orange Money pour authentifier le client. Le flux est le suivant :
  1. Vous appelez /pay/v01/straight/checkout-invoice/create avec le numéro du client.
  2. 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/ci/...).
  3. Vous redirigez le navigateur du client vers cette URL.
  4. Le client s’authentifie et confirme le paiement sur le portail Orange.
  5. 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

1

Collecter le numéro du client

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

Soumettre la requête

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

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/ci/...).
4

Rediriger le client

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

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": "2250707000000",
        "customer_firstname": "Aya",
        "customer_lastname": "Kouassi",
        "customer_email": "aya@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-00061"
      }
    }
  }'

Réponse attendue

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "response_text": "https://mpayment.orange-money.com/ci/mpayment/abstract/v1nd8lrkjniiezp3gus76kvmlgztvuylkcs2y5kiir6stko13emvuabrv95oaufb",
  "description": "",
  "custom_data": {
    "transaction_id": "ORD-2025-00061",
    "logfile": "202605111744086a021568f2037"
  },
  "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ètreValeur
Montant minimum10 XOF
Montant maximum
Limite quotidienne

Pages associées