Orange Money — RD Congo

Intégrer Orange Money RD Congo avec l’API LigdiCash. Mode de validation : Redirection LigdiCash (page de paiement pré-filtrée).

​

Identité

Champ	Valeur
Pays	RD Congo
Opérateur	Orange Money RD Congo
operator_id	34
operator_name	ORANGE RDC CONGO
Indicatif	+243
Format du numéro	243XXXXXXXXX (sans + ni espaces)
Endpoint	POST /pay/v01/straight/checkout-invoice/create
Mode de validation	Redirection LigdiCash

​

Mode de validation : Redirection LigdiCash

Pour Orange Money RD Congo, l’intégration LigdiCash passe actuellement par une page web LigdiCash dédiée, plutôt que par un traitement direct via l’API. Le flux est le suivant :

1. Vous appelez /pay/v01/straight/checkout-invoice/create avec le numéro du client dans customer et otp: "".
2. LigdiCash répond avec le token de transaction et un champ response_text qui contient l’URL d’une page de paiement LigdiCash où le numéro est prérempli et où seul Orange RDC est proposé.
3. Vous redirigez le navigateur du client vers cette URL.
4. Le client confirme le paiement depuis la page LigdiCash et le paiement procède selon le flux propre à l’opérateur.
5. LigdiCash vous notifie le résultat final via votre callback_url.

Le préremplissage de customer avec le numéro du client est obligatoire. Sans customer, le filtrage par numéro ne fonctionne pas et la page de paiement n’affichera pas Orange RDC correctement.

Ce mode utilise bien l’endpoint /straight/checkout-invoice/create (payin sans redirection). Ne pas confondre avec le payin avec redirection, qui utilise un endpoint distinct et expose une page de paiement multi-opérateurs.

​

UX recommandée

1. Collecter le numéro du client

   Votre formulaire recueille le numéro de téléphone Orange Money RDC.

2. Soumettre la requête

   Requête sur POST /pay/v01/straight/checkout-invoice/create avec customer rempli et otp: "".

3. Récupérer l'URL de la page LigdiCash

   Dans la réponse, le champ response_text contient l’URL de la page de paiement LigdiCash dédiée.

4. Rediriger le client

   Redirigez le navigateur du client vers cette URL. La page affiche le numéro prérempli et Orange RDC pré-sélectionné.

5. Attendre le callback

   Le résultat final arrive via votre callback_url. Affichez un état d’attente — ne vous fiez pas au retour navigateur.

​

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": "243850000000",
        "customer_firstname": "Joseph",
        "customer_lastname": "Mwamba",
        "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-00057"
      }
    }
  }'

​

Réponse attendue

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "https://app.ligdicash.com/pay/.../checkout/...",
  "description": "",
  "custom_data": {
    "transaction_id": "ORD-2025-00057"
  },
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

Redirigez le client vers l’URL contenue dans response_text. La page de paiement n’affichera que Orange Money RDC avec le numéro prérempli.

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	10 XOF
Montant maximum	—
Limite quotidienne	—

​

Pages associées

• Modes de validation — Redirection LigdiCash — 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