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
PaysCôte d’Ivoire
OpérateurMoov Africa Côte d’Ivoire (Moov Money)
operator_id14
operator_nameMOOV CI
Indicatif+225
Format du numéro225XXXXXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationUSSD Push (fallback : USSD guidé)

​
Modes de validation

Moov Côte d’Ivoire utilise deux modes selon la disponibilité réseau au moment de la transaction. Vous soumettez la même requête dans les deux cas — c’est l’opérateur qui décide du mode côté réseau. Mode principal — USSD Push : après votre requête, l’opérateur envoie directement un écran USSD push sur le téléphone du client. Le client valide avec son code PIN Moov Money. Aucune saisie supplémentaire côté marchand. Mode fallback — USSD guidé : si le push n’aboutit pas, l’opérateur envoie un SMS contenant la référence de transaction et le code USSD à composer. Le client compose le USSD pour valider. Exemple de SMS reçu en mode fallback : 
Vous avez une transaction 0000000433 - LIGDICASH_CI en attente.
Faites *155*15# pour payer.
Votre UX doit anticiper les deux cas. Affichez un message qui couvre les deux : le client recevra soit un push USSD à valider directement, soit un SMS avec les instructions à suivre.

​
UX recommandée

1

Collecter le numéro du client

Votre formulaire recueille uniquement le numéro de téléphone Moov. Aucun OTP à collecter.
2

Soumettre la requête

Requête avec le numéro dans customer et otp: "".
3

Afficher un message d'attente

Après soumission, affichez un message du type :
« Validez le paiement sur votre téléphone. Vous allez recevoir une demande de validation USSD, ou un SMS avec les instructions à suivre. »
Maintenez cet état d’attente jusqu’à la réception du callback.

​
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": "2250101000000",
        "customer_firstname": "Adama",
        "customer_lastname": "Koffi",
        "customer_email": "adama@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-00055"
      }
    }
  }'

​
Réponse attendue

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "Votre requête est en cours de traitement",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}
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 minimum100 XOF
Montant maximum—
Limite quotidienne—

​
Pages associées