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.

Les PayLinks vous permettent de créer des pages de paiement en quelques clics depuis le dashboard LigdiCash. Aucune intégration technique n’est requise : vous renseignez les informations du produit ou du service, et LigdiCash génère une URL de paiement que vous pouvez partager par WhatsApp, email, SMS ou réseaux sociaux.

​
Prérequis

  • Un compte LigdiCash actif
  • Un contrat PayLink signé avec LigdiCash (distinct du contrat API)
  • Un projet PayLink activé par l’équipe LigdiCash
Le contrat PayLink est séparé du contrat API de paiement. Contactez developper@ligdicash.com pour l’activer.

​
Structure : projets et PayLinks

Les PayLinks sont organisés en deux niveaux dans le dashboard : 
Projet PayLink "Ma Boutique"
├── PayLink "Chaussures Adidas — 25 000 XOF"  → paylink.ligdicash.com/adidas
├── PayLink "Facture client janvier"           → paylink.ligdicash.com/facture-jan
└── PayLink "Collecte association 2024"        → paylink.ligdicash.com/collecte-2024
Un projet PayLink est un container qui regroupe vos PayLinks. Chaque projet dispose de son propre sous-compte marchand, comme un projet API. Un PayLink est le lien de paiement individuel, associé à un produit ou un service. Depuis le dashboard : Marchands → Paylinks → Créer un nouveau PayLink.
ChampDescription
ProjetLe projet PayLink auquel ce lien est rattaché
LibelléNom du produit ou du service, affiché sur la page de paiement
Mot-cléSlug de l’URL (paylink.ligdicash.com/{mot-clé}) — sans espaces ni accents
DescriptionDescription longue affichée sur la page de paiement (éditeur enrichi)
Images descriptivesPhotos du produit ou du service

​
Configuration du paiement

Vous définissez un montant fixe en XOF. Le client ne peut pas le modifier. Adapté aux produits à prix unique.
Le client saisit lui-même le montant qu’il souhaite payer. Un champ libre s’affiche sur la page de paiement. Adapté aux dons ou aux paiements à montant libre.
Vous définissez un montant minimum. Le client peut payer ce montant ou davantage, mais pas moins. Adapté aux abonnements ou contributions avec minimum obligatoire.
Vous définissez un objectif de montant global. Chaque client contribue librement jusqu’à ce que l’objectif total soit atteint. Adapté aux levées de fonds ou aux cagnottes.

​
Autres paramètres

ParamètreOptions
Gestion du stockSans gestion / Avec gestion (limite le nombre d’achats)
Quantité achetéeLe client saisit la quantité ou non
Durée de vieIllimitée / Limitée (vous choisissez une date de début et de fin)
Action post-paiementVoir ci-dessous
Message post-paiementTexte affiché au client après le paiement réussi
Callback URLURL notifiée après chaque paiement (même fonctionnement que le callback API)

​
Action post-paiement

LigdiCash affiche le message post-paiement que vous avez saisi. Le client reste sur la page de confirmation LigdiCash.
Le client est redirigé vers une page de votre site après le paiement. Vous saisissez l’URL cible.
Les options « Générer un ticket » et « Téléchargement de fichier » existent dans l’interface mais ne sont pas fonctionnelles.

​
L’URL générée

Chaque PayLink est accessible à l’adresse : 
https://paylink.ligdicash.com/{mot-clé}
Cette URL est publique et partageable directement. Elle s’ouvre dans n’importe quel navigateur et affiche une page de paiement LigdiCash avec les opérateurs mobile money disponibles selon votre contrat.
Le mot-clé apparaît dans l’URL — choisissez-le court et mémorable. Exemple : facture-123 plutôt que paiement-de-la-facture-numero-123-janvier-2024.

​
Callback

Si vous renseignez une Callback URL, LigdiCash envoie une notification à votre serveur après chaque paiement validé. Le fonctionnement est identique au callback de l’API de paiement : double requête (application/x-www-form-urlencoded + application/json), même structure de payload. Consultez la section Sécurisation du callback pour le pattern de re-vérification recommandé.

​
Suivi des paiements

Les paiements reçus via un PayLink apparaissent dans Marchands → Payin avec la source PAYLINK. Chaque ligne affiche le token, le trans_id et un bouton PayLink pour identifier le lien d’origine. Les fonds sont crédités sur le sous-compte marchand du projet PayLink correspondant à l’opérateur utilisé par le client, comme pour tout paiement LigdiCash.

​
Différence avec l’API de paiement

API de paiementPayLinks
Intégration techniqueRequise (code backend)Aucune
Page de paiementHébergée par LigdiCashHébergée par LigdiCash
MontantDynamique (par requête API)Configurable (fixe / variable / plancher / collecte)
CallbackOuiOui
Public cibleDéveloppeursTout marchand
Contrat requisContrat APIContrat PayLink