Vodacom — DRC - LigdiCash

Identity

Field	Value
Country	DRC
Operator	Vodacom DRC (M-Pesa)
`operator_id`	`36`
`operator_name`	`VODACOM RDC CONGO`
Country code	+243
Number format	`243XXXXXXXXX` (no `+` or spaces)
Endpoint	`POST /pay/v01/straight/checkout-invoice/create`
Validation mode	USSD Push

Validation mode: USSD Push

After your request, the operator pushes a USSD prompt directly to the customer’s phone. The customer validates with their PIN. No extra input on the merchant side — the callback remains the source of truth.

Show a clear waiting message after submission. The USSD push reaches the customer’s phone within seconds, but the callback can take from a few seconds to several minutes depending on the operator.

Recommended UX

Collect the customer's number

Your form only collects the Vodacom phone number. No OTP to collect.

Submit the request

Request with the number in customer and otp: "".

Show a waiting message

After submission, display:

“Validate the payment on your phone. You will receive a USSD prompt to approve with your M-Pesa PIN.”

Keep the waiting state until the callback arrives.

Request example

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": "Pro Subscription — January 2025",
        "customer": "243810000000",
        "customer_firstname": "Jean",
        "customer_lastname": "Mukendi",
        "customer_email": "jean@example.com",
        "external_id": "",
        "otp": ""
      },
      "store": {
        "name": "MyApp",
        "website_url": "https://myapp.com"
      },
      "actions": {
        "cancel_url": "",
        "return_url": "",
        "callback_url": "https://myapp.com/api/callback/ligdicash"
      },
      "custom_data": {
        "transaction_id": "ORD-2025-00050"
      }
    }
  }'

const response = await fetch(
  "https://app.ligdicash.com/pay/v01/straight/checkout-invoice/create",
  {
    method: "POST",
    headers: {
      Apikey: process.env.LIGDICASH_API_KEY,
      Authorization: `Bearer ${process.env.LIGDICASH_API_TOKEN}`,
      Accept: "application/json",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      commande: {
        invoice: {
          items: [],
          total_amount: 5000,
          devise: "XOF",
          description: "Pro Subscription — January 2025",
          customer: "243810000000",
          customer_firstname: "Jean",
          customer_lastname: "Mukendi",
          customer_email: "jean@example.com",
          external_id: "",
          otp: "",
        },
        store: { name: "MyApp", website_url: "https://myapp.com" },
        actions: {
          cancel_url: "",
          return_url: "",
          callback_url: "https://myapp.com/api/callback/ligdicash",
        },
        custom_data: { transaction_id: "ORD-2025-00050" },
      },
    }),
  }
);

const data = await response.json();

$payload = [
  "commande" => [
    "invoice" => [
      "items" => [],
      "total_amount" => 5000,
      "devise" => "XOF",
      "description" => "Pro Subscription — January 2025",
      "customer" => "243810000000",
      "customer_firstname" => "Jean",
      "customer_lastname" => "Mukendi",
      "customer_email" => "jean@example.com",
      "external_id" => "",
      "otp" => "",
    ],
    "store" => ["name" => "MyApp", "website_url" => "https://myapp.com"],
    "actions" => [
      "cancel_url" => "",
      "return_url" => "",
      "callback_url" => "https://myapp.com/api/callback/ligdicash",
    ],
    "custom_data" => ["transaction_id" => "ORD-2025-00050"],
  ],
];

$ch = curl_init("https://app.ligdicash.com/pay/v01/straight/checkout-invoice/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Apikey: " . $_ENV["LIGDICASH_API_KEY"],
  "Authorization: Bearer " . $_ENV["LIGDICASH_API_TOKEN"],
  "Accept: application/json",
  "Content-Type: application/json",
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Expected response

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "Votre requête est en cours de traitement",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

{
  "response_code": "01",
  "token": "",
  "response_text": "Echec (Code00)",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

Store the token immediately after creation. Use it to call confirm when the callback is received — never rely on the token in the callback payload.

Limits

Parameter	Value
Minimum amount	10 XOF
Maximum amount	—
Daily limit	—

Validation modes — USSD Push — flow details
Create a transaction — full endpoint reference
Verify the status — call confirm after the callback

Getting started

Core concepts

Payment API

Guides

Error handling

SDKs & Plugins

Other products

AI tools

Resources

Vodacom — DRC

Identity

Validation mode: USSD Push

Recommended UX

Request example

Expected response

Limits

​Identity

​Validation mode: USSD Push

​Recommended UX

​Request example

​Expected response

​Limits

​Related pages

Identity

Validation mode: USSD Push

Recommended UX

Request example

Expected response

Limits

Related pages