# LigdiCash

> Documentation officielle de LigdiCash — agrégateur de paiement mobile money en Afrique de l'Ouest

## Docs

- [Claude Code](https://developers.ligdicash.com/ai-tools/claude-code.md): Configurer Claude Code pour générer du code d'intégration LigdiCash correct dès le premier essai
- [Cursor](https://developers.ligdicash.com/ai-tools/cursor.md): Configurer Cursor pour générer du code d'intégration LigdiCash correct dès le premier essai
- [Windsurf](https://developers.ligdicash.com/ai-tools/windsurf.md): Configurer Windsurf (Cascade) pour générer du code d'intégration LigdiCash correct dès le premier essai
- [Configurer l'URL de callback](https://developers.ligdicash.com/api-paiement/callback/configuration.md): Comment définir une URL de callback fiable, accessible publiquement et prête à recevoir les notifications LigdiCash.
- [Exemples par framework](https://developers.ligdicash.com/api-paiement/callback/exemples-frameworks.md): Implémentations complètes du callback LigdiCash en PHP, Laravel, Node.js Express et Python.
- [Idempotence et déduplication](https://developers.ligdicash.com/api-paiement/callback/idempotence.md): LigdiCash envoie deux requêtes POST par événement. Comment garantir que votre traitement n'est exécuté qu'une seule fois.
- [Le callback (webhook) — Introduction](https://developers.ligdicash.com/api-paiement/callback/introduction.md): LigdiCash envoie un POST sur votre URL de callback à chaque événement de paiement. Le mécanisme central pour la fiabilité de votre intégration.
- [Parser custom_data dans le callback](https://developers.ligdicash.com/api-paiement/callback/parser-custom-data.md): Comment extraire votre transaction_id depuis custom_data et pourquoi external_id est le raccourci recommandé.
- [Anatomie du payload — Payin](https://developers.ligdicash.com/api-paiement/callback/payload-payin.md): Détail de chaque champ du payload reçu lors d'un paiement entrant. Exemple réel et explication champ par champ.
- [Anatomie du payload — Payout](https://developers.ligdicash.com/api-paiement/callback/payload-payout.md): Détail du payload reçu lors d'un callback payout : structure, champs et différences avec le payload payin.
- [Sécuriser le callback](https://developers.ligdicash.com/api-paiement/callback/securisation.md): Pourquoi ne jamais faire confiance au payload reçu, et comment re-vérifier chaque callback avec le token stocké à la création.
- [3D Secure](https://developers.ligdicash.com/api-paiement/cartes-visa/3d-secure.md): Le 3D Secure est obligatoire pour tout paiement par carte Visa via LigdiCash — ce que c'est, comment ça fonctionne et que faire en cas d'échec.
- [Activer Visa sur votre projet](https://developers.ligdicash.com/api-paiement/cartes-visa/activation.md): Conditions contractuelles et démarches pour activer l'acceptation des paiements par carte Visa sur votre projet LigdiCash.
- [Flux de paiement Visa](https://developers.ligdicash.com/api-paiement/cartes-visa/flux-paiement.md): Comment se déroule un paiement par carte Visa via LigdiCash — de la création de facture à la confirmation.
- [Cartes Visa — Introduction](https://developers.ligdicash.com/api-paiement/cartes-visa/introduction.md): Acceptez les paiements par carte Visa via LigdiCash — prérequis, contraintes et différences avec le mobile money.
- [Créer une facture](https://developers.ligdicash.com/api-paiement/payin-redirect/creer-facture.md): Endpoint POST /pay/v01/redirect/checkout-invoice/create — paramètres, exemple complet et réponse.
- [Intégration mobile native](https://developers.ligdicash.com/api-paiement/payin-redirect/integration-mobile.md): Intégrer le payin avec redirection dans une app iOS, Android, React Native ou Flutter : WebView, détection du retour et confirmation du paiement.
- [Payin avec redirection](https://developers.ligdicash.com/api-paiement/payin-redirect/introduction.md): Le client est redirigé vers la page de paiement LigdiCash. La méthode la plus simple à intégrer, compatible avec tous les opérateurs supportés.
- [Pièges courants — payin avec redirection](https://developers.ligdicash.com/api-paiement/payin-redirect/pieges-courants.md): Les erreurs classiques à éviter avec le payin redirect LigdiCash : iframe bloqué, customer non vide, popup bloqué, validation côté client, et plus.
- [Rediriger le client vers la page de paiement](https://developers.ligdicash.com/api-paiement/payin-redirect/rediriger-client.md): Comment ouvrir le lien de paiement LigdiCash : même onglet, nouvel onglet, popup ou WebView native. Contraintes et patterns recommandés.
- [Vérifier le statut d'une transaction](https://developers.ligdicash.com/api-paiement/payin-redirect/verifier-statut.md): Endpoint GET /pay/v01/redirect/checkout-invoice/confirm — comment vérifier qu'une facture a bien été payée après redirection ou callback.
- [Créer une transaction](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/creer-transaction.md): Endpoint POST /pay/v01/straight/checkout-invoice/create — paramètres, exemples par mode de validation et réponse.
- [Payin sans redirection](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/introduction.md): Collectez des paiements directement dans votre interface, sans rediriger votre client vers LigdiCash. Vous gérez l'UX, LigdiCash gère l'opérateur.
- [Modes de validation](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/modes-validation.md): Les six modes de validation du payin sans redirection : OTP USSD, USSD Push, USSD guidé, OTP SMS, Redirection LigdiCash, Redirection opérateur. Comprendre les flux et adapter votre UX.
- [Africell — RD Congo](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/africell-rdc.md): Intégrer Africell Money RD Congo avec l'API LigdiCash. Mode de validation : USSD Push.
- [Airtel — Niger](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/airtel-niger.md): Intégrer Airtel Money Niger avec l'API LigdiCash. Mode de validation : USSD Push.
- [Airtel — RD Congo](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/airtel-rdc.md): Intégrer Airtel Money RD Congo avec l'API LigdiCash. Mode de validation : USSD Push.
- [Free — Sénégal](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/free-senegal.md): Intégrer Free Sénégal avec l'API LigdiCash. Mode de validation : Redirection LigdiCash (page de paiement pré-filtrée).
- [Moov Africa — Bénin](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/moov-benin.md): Intégrer Moov Africa Bénin avec l'API LigdiCash. Mode de validation : USSD Push.
- [Moov Africa — Burkina Faso](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/moov-burkina.md): Intégrer Moov Africa Burkina Faso avec l'API LigdiCash. Mode de validation : USSD Push avec fallback USSD guidé.
- [Moov Africa — Côte d'Ivoire](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/moov-cote-divoire.md): Intégrer Moov Africa Côte d'Ivoire avec l'API LigdiCash. Mode de validation : USSD Push avec fallback USSD guidé.
- [Moov Africa — Niger](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/moov-niger.md): Intégrer Moov Africa Niger avec l'API LigdiCash. Mode de validation : USSD Push.
- [Moov Africa — Togo](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/moov-togo.md): Intégrer Moov Africa Togo avec l'API LigdiCash. Mode de validation : USSD Push.
- [MTN Mobile Money — Bénin](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/mtn-benin.md): Intégrer MTN Mobile Money Bénin avec l'API LigdiCash. Mode de validation : USSD Push.
- [MTN Mobile Money — Côte d'Ivoire](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/mtn-cote-divoire.md): Intégrer MTN Mobile Money Côte d'Ivoire avec l'API LigdiCash. Mode de validation : USSD guidé.
- [MTN Mobile Money — Guinée Conakry](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/mtn-guinee.md): Intégrer MTN Mobile Money Guinée Conakry avec l'API LigdiCash. Mode de validation : Redirection LigdiCash (page de paiement pré-filtrée).
- [Orange Money — Burkina Faso](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/orange-burkina.md): Intégrer Orange Money Burkina Faso avec l'API LigdiCash. Mode de validation : OTP USSD.
- [Orange Money — Côte d'Ivoire](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/orange-cote-divoire.md): Intégrer Orange Money Côte d'Ivoire avec l'API LigdiCash. Mode de validation : Redirection opérateur (portail Orange Money).
- [Orange Money — Guinée Conakry](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/orange-guinee.md): Intégrer Orange Money Guinée Conakry avec l'API LigdiCash. Mode de validation : Redirection LigdiCash (page de paiement pré-filtrée).
- [Orange Money — Mali](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/orange-mali.md): Intégrer Orange Money Mali avec l'API LigdiCash. Mode de validation : Redirection opérateur (portail Orange Money).
- [Orange Money — RD Congo](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/orange-rdc.md): Intégrer Orange Money RD Congo avec l'API LigdiCash. Mode de validation : Redirection LigdiCash (page de paiement pré-filtrée).
- [Orange Money — Sénégal](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/orange-senegal.md): Intégrer Orange Money Sénégal avec l'API LigdiCash. Mode de validation : Redirection LigdiCash (page de paiement pré-filtrée).
- [Vodacom — RD Congo](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/vodacom-rdc.md): Intégrer Vodacom RD Congo (M-Pesa) avec l'API LigdiCash. Mode de validation : USSD Push.
- [Wallet LigdiCash](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/wallet-ligdicash.md): Intégrer le paiement via wallet LigdiCash. Mode de validation : OTP SMS. Deux endpoints distincts : /v02/debitotp et /v02/debitwallet/withotp.
- [Wave — Sénégal](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/wave-senegal.md): Intégrer Wave Sénégal avec l'API LigdiCash. Mode de validation : Redirection LigdiCash (page de paiement pré-filtrée).
- [YAS — Togo](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/yas-togo.md): Intégrer YAS Togo (ex-Togocom Mixx by Yas) avec l'API LigdiCash. Mode de validation : USSD Push.
- [Zamani — Niger](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/operateurs/zamani-niger.md): Intégrer Zamani Telecom Niger (Zamani Money) avec l'API LigdiCash. Mode de validation : USSD guidé.
- [Vérifier le statut](https://developers.ligdicash.com/api-paiement/payin-sans-redirect/verifier-statut.md): Comment et quand appeler l'endpoint confirm après un payin sans redirection. Stratégies de polling selon le mode de validation.
- [Cas d'usage du payout](https://developers.ligdicash.com/api-paiement/payout/cas-usage.md): Remboursements, salaires, gains, paiement de prestataires — choisir la bonne méthode payout selon le contexte.
- [Payout — Introduction](https://developers.ligdicash.com/api-paiement/payout/introduction.md): Envoyez des fonds à vos clients ou prestataires : Payout Client vers un wallet LigdiCash, ou Payout Marchand directement vers un compte mobile money.
- [Vérifier le statut d'un payout](https://developers.ligdicash.com/api-paiement/payout/verifier-statut.md): Interrogez GET /pay/v01/withdrawal/confirm pour connaître le résultat d'un payout après sa création.
- [Payout Marchand — vers mobile money](https://developers.ligdicash.com/api-paiement/payout/vers-mobile-money.md): Transférez des fonds directement vers un numéro mobile money avec POST /pay/v01/straight/payout, sans wallet LigdiCash intermédiaire.
- [Payout Client — vers wallet LigdiCash](https://developers.ligdicash.com/api-paiement/payout/vers-wallet-ligdicash.md): Transférez des fonds vers le wallet LigdiCash d'un bénéficiaire avec POST /pay/v01/withdrawal/create.
- [Vérification de statut — Vue d'ensemble](https://developers.ligdicash.com/api-paiement/verification-statut/introduction.md): Comment et quand vérifier le statut d'une transaction LigdiCash — payin ou payout — à tout moment.
- [Polling vs callback](https://developers.ligdicash.com/api-paiement/verification-statut/polling-vs-callback.md): Quand utiliser le polling (vérification active) et quand se fier au callback (notification passive) — avantages, limites et pattern hybride recommandé.
- [Recommandations de vérification](https://developers.ligdicash.com/api-paiement/verification-statut/recommandations.md): Intervalles de polling, timeouts, stratégie hybride et gestion des transactions en pending — les bonnes pratiques pour un suivi fiable.
- [Vue d'ensemble de l'API de paiement](https://developers.ligdicash.com/api-paiement/vue-ensemble.md): Choisissez la bonne méthode de paiement LigdiCash selon votre cas d'usage : payin avec ou sans redirection, payout client ou marchand.
- [PayLinks](https://developers.ligdicash.com/autres-produits/paylinks.md): Générez des liens de paiement depuis le dashboard LigdiCash, sans code ni intégration technique. Idéal pour les marchands sans site web.
- [SMS LigdiCash](https://developers.ligdicash.com/autres-produits/sms.md): Envoyez des SMS transactionnels et marketing à vos clients via l'infrastructure LigdiCash SMS, un service indépendant de l'API de paiement.
- [Authentification](https://developers.ligdicash.com/concepts/authentification.md): Comment authentifier vos requêtes vers l'API LigdiCash avec les en-têtes Apikey et Authorization.
- [Codes de réponse et statuts](https://developers.ligdicash.com/concepts/codes-reponse-statuts.md): Comprendre response_code, response_text et le champ wiki pour interpréter chaque réponse de l'API LigdiCash.
- [Le compte marchand LigdiCash](https://developers.ligdicash.com/concepts/compte-marchand.md): Structure du compte marchand LigdiCash : sous-comptes par opérateur, flux entrants et sortants, Cashin, Cashout et gestion des soldes.
- [Cycle de vie d'une transaction](https://developers.ligdicash.com/concepts/cycle-vie-transaction.md): Les trois statuts d'une transaction LigdiCash — pending, completed, notcompleted — et pourquoi une transaction peut rester pending indéfiniment.
- [Devises et montants](https://developers.ligdicash.com/concepts/devises-montants.md): LigdiCash opère exclusivement en XOF. Format des montants et limites par opérateur.
- [Environnements d'intégration](https://developers.ligdicash.com/concepts/environnements.md): LigdiCash ne dispose pas de sandbox. Durant la phase d'intégration, LigdiCash vous fournit un compte réel temporaire dédié aux tests.
- [Projet API](https://developers.ligdicash.com/concepts/projet-api.md): Le projet API LigdiCash est créé et activé par l'équipe technique, au terme des démarches administratives. Voici comment accéder à vos clés une fois le projet activé.
- [Tokens et identifiants](https://developers.ligdicash.com/concepts/tokens-et-identifiants.md): Différence entre token, request_id, transaction_id et external_id dans l'API LigdiCash — quel identifiant utiliser pour quoi.
- [Le pattern transaction_id : la règle d'or](https://developers.ligdicash.com/concepts/transaction-id-pattern.md): Pourquoi générer et stocker votre propre identifiant de transaction avant chaque appel API LigdiCash — et comment le retrouver dans le callback et le dashboard.
- [Le champ wiki](https://developers.ligdicash.com/erreurs/champ-wiki.md): Comment utiliser le champ wiki retourné par chaque endpoint pour décoder les sous-codes d'erreur Echec (CodeXX) en messages lisibles.
- [Erreurs courantes et solutions](https://developers.ligdicash.com/erreurs/erreurs-courantes.md): Les erreurs les plus fréquentes rencontrées par les marchands lors de l'intégration LigdiCash, leurs causes réelles et comment les résoudre.
- [Liste des sous-codes par endpoint](https://developers.ligdicash.com/erreurs/sous-codes.md): Référence complète des sous-codes Echec (CodeXX) retournés par chaque endpoint LigdiCash, avec leur description et l'action recommandée.
- [Gestion des erreurs — Vue d'ensemble](https://developers.ligdicash.com/erreurs/vue-ensemble.md): Comprendre les deux niveaux d'erreur de l'API LigdiCash : rejet de la requête (response_code) et échec de la transaction (callback/confirm).
- [Introduction](https://developers.ligdicash.com/essentials/introduction.md): Bienvenue dans la documentation LigdiCash. Découvrez notre solution de paiement mobile money en Afrique de l'Ouest.
- [Protocole d'intégration](https://developers.ligdicash.com/essentials/protocole-integration.md): Le parcours complet pour devenir partenaire LigdiCash : démarches administratives, formation, intégration technique et mise en production.
- [Quickstart — Premier paiement en 5 minutes](https://developers.ligdicash.com/essentials/quickstart.md): Réalisez votre premier payin avec redirection de bout en bout : créer la facture, rediriger le client, recevoir le callback et vérifier le paiement.
- [Architecture recommandée](https://developers.ligdicash.com/guides/architecture-recommandee.md): Comment structurer votre backend pour intégrer LigdiCash en toute sécurité : proxy, base de données, gestion du callback et fallback polling.
- [Checklist de mise en production](https://developers.ligdicash.com/guides/checklist-production.md): Vérifications techniques, sécurité et business à effectuer avant de basculer votre intégration LigdiCash en production.
- [Guide e-commerce : panier → paiement → livraison](https://developers.ligdicash.com/guides/quickstart-ecommerce.md): Implémentez un flux de paiement complet avec LigdiCash : création de commande, paiement mobile money, réception du callback et confirmation de livraison.
- [Guide mobile : React Native et Flutter](https://developers.ligdicash.com/guides/quickstart-mobile.md): Intégrer LigdiCash dans une application mobile React Native ou Flutter : architecture, WebView, gestion du retour et confirmation côté backend.
- [Envoyer l'OTP Wallet LigdiCash](https://developers.ligdicash.com/reference/endpoints/debit-otp.md): Déclenche l'envoi d'un OTP SMS au client pour authentifier un paiement via son wallet LigdiCash. Première étape du flux wallet.
- [Soumettre un paiement Wallet LigdiCash](https://developers.ligdicash.com/reference/endpoints/debit-wallet-with-otp.md): Finalise un paiement via wallet LigdiCash en soumettant l'OTP reçu par le client. Deuxième étape du flux wallet.
- [Vérifier le statut d'une facture payin](https://developers.ligdicash.com/reference/endpoints/payin-redirect-confirm.md): Vérifie le statut d'une facture payin (redirect ou sans redirect) à partir du token de création.
- [Créer une facture payin redirect](https://developers.ligdicash.com/reference/endpoints/payin-redirect-create.md): Crée une facture de paiement avec redirection et retourne l'URL de la page de paiement LigdiCash.
- [Créer une transaction payin sans redirect](https://developers.ligdicash.com/reference/endpoints/payin-straight-create.md): Initie un paiement mobile money directement depuis votre interface, sans redirection vers une page LigdiCash.
- [Créer un payout mobile money direct](https://developers.ligdicash.com/reference/endpoints/straight-payout.md): Transfère des fonds directement vers un numéro mobile money, sans compte LigdiCash intermédiaire.
- [Vérifier le statut d'un payout](https://developers.ligdicash.com/reference/endpoints/withdrawal-confirm.md): Interroge le statut d'un payout (wallet ou mobile money) à partir du token retourné à la création.
- [Créer un payout wallet](https://developers.ligdicash.com/reference/endpoints/withdrawal-create.md): Transfère des fonds vers le wallet LigdiCash d'un bénéficiaire, avec option de virement automatique vers son mobile money.
- [Référence API](https://developers.ligdicash.com/reference/introduction.md): URL de base, en-têtes obligatoires, format des requêtes et des réponses pour tous les endpoints LigdiCash.
- [Opérateurs supportés](https://developers.ligdicash.com/reference/operateurs-supportes.md): Tableau maître de tous les opérateurs supportés par LigdiCash : pays, operator_name, mode de validation, endpoint, montant minimum.
- [Changelog](https://developers.ligdicash.com/ressources/changelog.md): Historique des changements de l'API LigdiCash et de la documentation officielle.
- [FAQ](https://developers.ligdicash.com/ressources/faq.md): Questions fréquentes sur l'intégration LigdiCash — technique, compte, business.
- [Glossaire](https://developers.ligdicash.com/ressources/glossaire.md): Définitions des termes techniques et métier utilisés dans la documentation LigdiCash.
- [Support](https://developers.ligdicash.com/ressources/support.md): Contacter l'équipe LigdiCash — canaux disponibles, contacts par pays, et comment bien rapporter un problème.
- [SDK Dart / Flutter](https://developers.ligdicash.com/sdk/dart-flutter.md): Installez et utilisez le SDK Dart LigdiCash dans vos applications Flutter iOS et Android.
- [SDK JavaScript / TypeScript](https://developers.ligdicash.com/sdk/javascript.md): Installez et utilisez le SDK JavaScript LigdiCash pour Node.js, TypeScript et NestJS. Types TypeScript inclus.
- [SDK PHP](https://developers.ligdicash.com/sdk/php.md): Installez et utilisez le SDK PHP LigdiCash pour vos backends Laravel, Symfony ou PHP vanilla.
- [SDK Python](https://developers.ligdicash.com/sdk/python.md): Installez et utilisez le SDK Python LigdiCash pour vos backends Django, Flask, FastAPI ou scripts serveur.
- [Skill LigdiCash pour agent IA](https://developers.ligdicash.com/sdk/skill-ia.md): Installez le skill LigdiCash pour que Claude Code connaisse l'API dès le départ — endpoints, patterns de sécurité et pièges documentés.
- [SDK officiels](https://developers.ligdicash.com/sdk/vue-ensemble.md): Choisissez le SDK LigdiCash adapté à votre stack : Python, JavaScript/TypeScript, PHP ou Dart/Flutter.
- [Plugin WordPress / WooCommerce](https://developers.ligdicash.com/sdk/wordpress-woocommerce.md): Installez et configurez le plugin LigdiCash pour accepter les paiements mobile money sur votre boutique WooCommerce, sans écrire de code.

## Optional

- [Site web LigdiCash](https://ligdicash.com)
- [Dashboard](https://client.ligdicash.com)
- [Support](mailto:support@ligdicash.com)