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.

Le payin avec redirection est la méthode d’intégration la plus rapide. Vous créez une facture via l’API, récupérez un lien de paiement, et redirigez votre client vers la page hébergée par LigdiCash. Le client choisit son opérateur, effectue son paiement, et est renvoyé vers votre site. Vous n’avez pas à gérer l’interface de paiement. Cette méthode fonctionne aussi bien sur le web que dans les applications mobiles natives : le lien de paiement s’ouvre dans une WebView, et vous détectez le retour du client en écoutant les changements d’URL.

​
Comment ça fonctionne

1

Créer la facture

Vous appelez POST /pay/v01/redirect/checkout-invoice/create avec les détails de la commande. LigdiCash vous retourne un token et un lien de paiement dans response_text.
2

Rediriger le client

Vous ouvrez le lien de paiement dans le même onglet, un nouvel onglet ou un popup. Le client arrive sur la page de paiement LigdiCash où il choisit son opérateur mobile money.
3

Le client paie

Le client saisit son numéro et valide le paiement selon les instructions de son opérateur. LigdiCash gère entièrement cette étape.
4

Notification et redirection

LigdiCash envoie un callback à votre callback_url et redirige le client vers votre return_url (succès) ou cancel_url (annulation).

​
Contraintes importantes

L’iframe est bloqué par LigdiCash. Le lien de paiement doit s’ouvrir dans le même onglet, un nouvel onglet, un popup, ou une WebView native sur mobile — jamais dans une iframe.
Le champ customer doit rester vide (""). Si vous y renseignez un numéro de téléphone, LigdiCash filtre la page de paiement pour n’afficher que les opérateurs correspondant à ce numéro, masquant les autres.

​
Dans cette section

Créer une facture

Paramètres, payload complet et réponse de l’endpoint de création

Rediriger le client

Ouvrir le lien de paiement : même onglet, popup, WebView

Vérifier le statut

Appeler l’endpoint confirm avec le token de création

Intégration mobile

Ouvrir le lien dans une WebView native et détecter le retour

Pièges courants

Iframe, customer vide, popup bloqué — les erreurs fréquentes