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.

Un paiement Visa sur LigdiCash suit le même flux technique qu’un payin avec redirection. La différence est côté client : au lieu de choisir un opérateur mobile money et de saisir un numéro de téléphone, le client saisit ses informations de carte bancaire et valide via le 3D Secure.
Le flux Visa n’est pas disponible en mode sans redirection. La page de paiement hébergée par LigdiCash est obligatoire pour gérer la saisie sécurisée des informations de carte.

​
Vue d’ensemble du flux

1

Créer la facture

Votre backend appelle POST /pay/v01/redirect/checkout-invoice/create avec les paramètres habituels — c’est exactement le même endpoint que pour le mobile money.LigdiCash retourne un token et un payment_url.
2

Rediriger le client

Ouvrez payment_url dans le même onglet, un nouvel onglet, ou un popup. Le client arrive sur la page de paiement LigdiCash, qui affiche les méthodes disponibles sur votre compte — dont Visa si l’activation est en place.
L’iframe est bloqué pour ce flux. N’intégrez pas payment_url dans une iframe — le paiement ne fonctionnera pas. Consultez Rediriger le client pour les méthodes d’ouverture supportées.
3

Le client saisit ses informations de carte

Sur la page LigdiCash, le client sélectionne Visa et saisit :
  • Numéro de carte
  • Date d’expiration
  • CVV
La carte doit avoir le 3D Secure activé. Si ce n’est pas le cas, le paiement sera refusé. Le client doit contacter sa banque pour activer cette option.
4

Authentification 3D Secure

LigdiCash déclenche automatiquement le processus 3D Secure. Le client est redirigé vers la page d’authentification de sa banque (code SMS, application bancaire, etc.) pour confirmer la transaction.Consultez 3D Secure pour le détail de cette étape.
5

Retour sur votre site

Après validation (ou échec), le client est redirigé vers votre return_url (succès ou annulation) ou cancel_url.Appelez confirm depuis votre backend avec le token stocké à la création pour vérifier le statut réel avant d’honorer la commande.
6

Callback

LigdiCash envoie un callback à votre callback_url dès que le statut est finalisé. Re-vérifiez toujours le statut avec confirm avant de déclencher votre logique métier.

​
Côté marchand — aucune modification technique

Le flux Visa utilise exactement les mêmes appels API que le payin redirect mobile money :
ÉtapeEndpoint
Créer la facturePOST /pay/v01/redirect/checkout-invoice/create
Vérifier le statutGET /pay/v01/redirect/checkout-invoice/confirm?token={TOKEN}
Les headers, le body, et le format de réponse sont identiques. Visa apparaît automatiquement comme option de paiement sur la page LigdiCash si votre compte l’a activé.

​
Côté client — expérience attendue

Le client voit sur la page LigdiCash une option « Carte Visa » en plus des opérateurs mobile money disponibles. Après saisie des données de carte, il est redirigé vers sa banque pour le 3D Secure, puis revient sur votre site. L’ensemble du flux dure typiquement 1 à 2 minutes si le client a ses informations de carte à portée de main et que le 3D Secure se déroule normalement.

​
Callback Visa

Le payload du callback est identique au callback d’un payin mobile money. Le champ operator_name indiquera "VISA". Consultez Payload du callback payin pour la structure complète.

​
Pages associées