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
PaysRD Congo
OpérateurAfricell RDC (Africell Money)
operator_id38
operator_nameAFRICELL RDC CONGO
Indicatif+243
Format du numéro243XXXXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationUSSD 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 Africell 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 Africell. 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 Africell Money. »
Maintenez l’é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": "243990000000",
        "customer_firstname": "Patrick",
        "customer_lastname": "Lumumba",
        "customer_email": "patrick@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-00052"
      }
    }
  }'

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