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.

Ce guide vous fait parcourir le flux complet d’un payin avec redirection : vous créez une facture, vous redirigez votre client vers la page de paiement LigdiCash, vous recevez le callback, et vous vérifiez le statut avec l’endpoint confirm.

​
Prérequis

  • Votre Apikey et votre API_TOKEN disponibles dans votre dashboard LigdiCash
  • Une callback_url accessible publiquement depuis internet (pas localhost)
Pour exposer un serveur local lors du développement, vous pouvez utiliser un outil comme ngrok.

​
Étape 1 — Créer la transaction

Appelez l’endpoint de création en passant votre transaction_id dans custom_data. Stockez le token retourné — vous en aurez besoin à l’étape 4. 
curl -X POST https://app.ligdicash.com/pay/v01/redirect/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": [
          { "name": "Abonnement Pro", "price": 5000, "quantity": 1 }
        ],
        "total_amount": 5000,
        "devise": "XOF",
        "description": "Abonnement Pro — Janvier 2025",
        "customer": "",
        "customer_firstname": "Amadou",
        "customer_lastname": "Diallo",
        "customer_email": "amadou@exemple.com"
      },
      "store": {
        "name": "MonApp",
        "website_url": "https://monapp.com"
      },
      "actions": {
        "cancel_url": "https://monapp.com/paiement/annule",
        "return_url": "https://monapp.com/paiement/succes",
        "callback_url": "https://monapp.com/api/callback/ligdicash"
      },
      "custom_data": {
        "transaction_id": "ORD-2025-00042"
      }
    }
  }'
La réponse en cas de succès contient dans response_text l’URL de la page de paiement : 
{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "https://app.ligdicash.com/pay/invoice/eyJ0eXAiOiJKV1Qi...",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

​
Étape 2 — Rediriger le client

L’URL de paiement est dans response_text. Ouvrez-la dans le même onglet ou un nouvel onglet — jamais dans une iframe.
Node.js
// Même onglet
window.location.href = paymentUrl;

// Nouvel onglet
window.open(paymentUrl, "_blank");
L’iframe est bloqué par LigdiCash. Le lien de paiement doit obligatoirement s’ouvrir dans le même onglet, un nouvel onglet, un popup, ou une WebView native sur mobile.
Une fois le paiement effectué ou annulé, LigdiCash redirige le client vers votre return_url ou cancel_url.

​
Étape 3 — Recevoir le callback

LigdiCash envoie une requête POST à votre callback_url quand le statut de la transaction change.
Node.js (Express)
app.post("/api/callback/ligdicash", async (req, res) => {
  // Idéalement, toujours répondre 200 en premier
  res.status(200).json({ ok: true });

  const payload = req.body;

  // Extraire votre transaction_id depuis custom_data
  const entry = payload.custom_data?.find(
    (item) => item.keyof_customdata === "transaction_id"
  );
  const transactionId = entry?.valueof_customdata;

  if (!transactionId) return;

  // Récupérer le token stocké à la création (étape 1)
  const order = await db.orders.findOne({ ligdicash_tx_id: transactionId });
  if (!order) return;

  // Re-vérifier le statut avec confirm (étape 4)
  await verifyAndUpdateOrder(order);
});
Par convention, répondez 200 à LigdiCash pour accuser réception du callback.

​
Étape 4 — Vérifier avec confirm

N’accordez jamais confiance au seul payload du callback. Appelez confirm avec le token stocké à la création pour valider le statut. 
curl -X GET "https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm/?invoiceToken={TOKEN}" \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Accept: application/json"

​
Et après ?

Votre premier paiement fonctionne. Pour aller plus loin :

Payin sans redirection

Initiez le paiement directement depuis votre interface, sans quitter votre app

Sécuriser le callback

Le pattern complet de re-vérification et de déduplication

Payout

Effectuez des virements vers vos clients ou partenaires

Tous les opérateurs

Orange Money, Moov, MTN, Wave et plus encore