Orange Money — Côte d'Ivoire

Identity

Field	Value
Country	Côte d’Ivoire
Operator	Orange Money Côte d’Ivoire
`operator_id`	`16`
`operator_name`	`ORANGE CI`
Country code	+225
Number format	`225XXXXXXXXXX` (no `+` or spaces)
Endpoint	`POST /pay/v01/straight/checkout-invoice/create`
Validation mode	Operator redirect

Validation mode: Operator redirect

For Orange Money Côte d’Ivoire, the LigdiCash integration goes through the Orange Money web portal to authenticate the customer. The flow is:

You call /pay/v01/straight/checkout-invoice/create with the customer’s number.
LigdiCash responds with the transaction token and a response_text field containing the Orange Money portal URL (https://mpayment.orange-money.com/ci/...).
You redirect the customer’s browser to that URL.
The customer authenticates and confirms the payment on the Orange portal.
LigdiCash notifies you of the final result via your callback_url.

The customer’s browser-side return after the Orange portal is not guaranteed — the user may close the tab, lose connectivity, or never return. The callback remains the only source of truth. Never validate the payment based on the customer’s return alone.

This mode does use the /straight/checkout-invoice/create endpoint (direct payin), but the user journey includes an external redirect to the operator’s portal. Do not confuse this with hosted payin, which uses the /redirect/checkout-invoice/create endpoint and exposes the LigdiCash payment page.

Recommended UX

Collect the customer's number

Your form only collects the Orange Money CI phone number.

Submit the request

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

Retrieve the portal URL

In the response, the response_text field contains the Orange Money portal URL (https://mpayment.orange-money.com/ci/...).

Redirect the customer

Redirect the customer’s browser to that URL. The customer authenticates on the Orange portal and confirms the payment.

Wait for the callback

The final result arrives via your callback_url. Show a waiting state until the callback arrives — do not rely on the browser-side return.

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": "2250707000000",
        "customer_firstname": "Aya",
        "customer_lastname": "Kouassi",
        "customer_email": "aya@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-00061"
      }
    }
  }'

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: "2250707000000",
          customer_firstname: "Aya",
          customer_lastname: "Kouassi",
          customer_email: "aya@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-00061" },
      },
    }),
  }
);

const data = await response.json();
// Redirect the customer to the Orange portal
window.location.href = data.response_text;

$payload = [
  "commande" => [
    "invoice" => [
      "items" => [],
      "total_amount" => 5000,
      "devise" => "XOF",
      "description" => "Pro Subscription — January 2025",
      "customer" => "2250707000000",
      "customer_firstname" => "Aya",
      "customer_lastname" => "Kouassi",
      "customer_email" => "aya@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-00061"],
  ],
];

$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);
// Redirect the customer to the Orange portal
header("Location: " . $data["response_text"]);

Expected response

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "response_text": "https://mpayment.orange-money.com/ci/mpayment/abstract/v1nd8lrkjniiezp3gus76kvmlgztvuylkcs2y5kiir6stko13emvuabrv95oaufb",
  "description": "",
  "custom_data": {
    "transaction_id": "ORD-2025-00061",
    "logfile": "202605111744086a021568f2037"
  },
  "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 — Operator redirect — 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

Orange Money — Côte d'Ivoire

Identity

Validation mode: Operator redirect

Recommended UX

Request example

Expected response

Limits

​Identity

​Validation mode: Operator redirect

​Recommended UX

​Request example

​Expected response

​Limits

​Related pages

Identity

Validation mode: Operator redirect

Recommended UX

Request example

Expected response

Limits

Related pages