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
PaysGuinée Conakry
OpérateurMTN Mobile Money Guinée
operator_id51
operator_nameMTN GUINEE
Indicatif+224
Format du numéro224XXXXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationRedirection LigdiCash

​
Mode de validation : Redirection LigdiCash

Pour MTN Mobile Money Guinée, l’intégration LigdiCash passe actuellement par une page web LigdiCash dédiée, plutôt que par un traitement direct via l’API. Le flux est le suivant :
  1. Vous appelez /pay/v01/straight/checkout-invoice/create avec le numéro du client dans customer et otp: "".
  2. LigdiCash répond avec le token de transaction et un champ response_text qui contient l’URL d’une page de paiement LigdiCash où le numéro est prérempli et où seul MTN Guinée est proposé.
  3. Vous redirigez le navigateur du client vers cette URL.
  4. Le client confirme le paiement depuis la page LigdiCash et le paiement procède selon le flux propre à l’opérateur.
  5. LigdiCash vous notifie le résultat final via votre callback_url.
Le préremplissage de customer avec le numéro du client est obligatoire. Sans customer, le filtrage par numéro ne fonctionne pas et la page de paiement n’affichera pas MTN Guinée correctement.
Ce mode utilise bien l’endpoint /straight/checkout-invoice/create (payin sans redirection). Ne pas confondre avec le payin avec redirection, qui utilise un endpoint distinct et expose une page de paiement multi-opérateurs.

​
UX recommandée

1

Collecter le numéro du client

Votre formulaire recueille le numéro de téléphone MTN Guinée.
2

Soumettre la requête

Requête sur POST /pay/v01/straight/checkout-invoice/create avec customer rempli et otp: "".
3

Récupérer l'URL de la page LigdiCash

Dans la réponse, le champ response_text contient l’URL de la page de paiement LigdiCash dédiée.
4

Rediriger le client

Redirigez le navigateur du client vers cette URL. La page affiche le numéro prérempli et MTN Guinée pré-sélectionné.
5

Attendre le callback

Le résultat final arrive via votre callback_url. Affichez un état d’attente — 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": "224620000000",
        "customer_firstname": "Mamadou",
        "customer_lastname": "Bah",
        "customer_email": "mamadou@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-00058"
      }
    }
  }'

​
Réponse attendue

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "https://app.ligdicash.com/pay/.../checkout/...",
  "description": "",
  "custom_data": {
    "transaction_id": "ORD-2025-00058"
  },
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}
Redirigez le client vers l’URL contenue dans response_text. La page de paiement n’affichera que MTN Mobile Money Guinée avec le numéro prérempli.
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 minimum200 XOF
Montant maximum—
Limite quotidienne—

​
Pages associées