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
PaysSénégal
OpérateurFree Sénégal
operator_id32
operator_nameFREE SENEGAL
Indicatif+221
Format du numéro221XXXXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationRedirection LigdiCash

​
Mode de validation : Redirection LigdiCash

Pour Free Sénégal, 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 Free Sénégal 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 Free Sénégal 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 Free Sénégal.
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 Free Sénégal 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": "221760000000",
        "customer_firstname": "Oumar",
        "customer_lastname": "Sow",
        "customer_email": "oumar@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-00066"
      }
    }
  }'

​
Réponse attendue

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "https://app.ligdicash.com/pay/.../checkout/...",
  "description": "",
  "custom_data": {
    "transaction_id": "ORD-2025-00066"
  },
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}
Redirigez le client vers l’URL contenue dans response_text. La page de paiement n’affichera que Free Sénégal 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 minimum—
Montant maximum—
Limite quotidienne—

​
Pages associées