Moov Africa — Togo

Intégrer Moov Africa Togo avec l’API LigdiCash. Mode de validation : USSD Push.

​

Identité

Champ	Valeur
Pays	Togo
Opérateur	Moov Africa Togo
operator_id	4
operator_name	MOOV TOGO
Indicatif	+228
Format du numéro	228XXXXXXXX (sans + ni espaces)
Endpoint	POST /pay/v01/straight/checkout-invoice/create
Mode de validation	USSD Push

​

Mode de validation : USSD Push

Après votre requête, l’opérateur envoie un push USSD directement sur le téléphone du client. Le client valide avec son code PIN Moov Money. Aucune saisie supplémentaire côté marchand — le callback reste la source de vérité.

Affichez un message d’attente clair après soumission. Le push USSD arrive sur le téléphone du client en quelques secondes, mais le callback peut prendre de quelques secondes à plusieurs minutes selon l’opérateur.

​

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 :

   « Validez le paiement sur votre téléphone. Vous allez recevoir une demande USSD à approuver avec votre code PIN Moov Money. »

   Maintenez l’état d’attente jusqu’à la réception du callback.

​

Exemple de requête

cURL

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": "22870000000",
        "customer_firstname": "Komi",
        "customer_lastname": "Agbeko",
        "customer_email": "[e-mail]",
        "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-00054"
      }
    }
  }'

​

Réponse attendue

Succès (create)

{
  "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ètre	Valeur
Montant minimum	100 XOF
Montant maximum	—
Limite quotidienne	—

​

Pages associées

• Modes de validation — USSD Push — détail du flux
• Créer une transaction — référence complète de l’endpoint
• Vérifier le statut — appeler confirm après le callback