> ## 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.

# Orange Money — Guinée Conakry

> Intégrer Orange Money Guinée Conakry avec l'API LigdiCash. Mode de validation : Redirection LigdiCash (page de paiement pré-filtrée).

## Identité

| Champ              | Valeur                                           |
| ------------------ | ------------------------------------------------ |
| Pays               | Guinée Conakry                                   |
| Opérateur          | Orange Money Guinée                              |
| `operator_id`      | `33`                                             |
| `operator_name`    | `ORANGE GUINEE`                                  |
| Indicatif          | +224                                             |
| Format du numéro   | `224XXXXXXXXX` (sans `+` ni espaces)             |
| Endpoint           | `POST /pay/v01/straight/checkout-invoice/create` |
| Mode de validation | Redirection LigdiCash                            |

## Mode de validation : Redirection LigdiCash

Pour Orange Money Guinée, 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 Guinée 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`.

<Warning>
  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 Guinée correctement.
</Warning>

<Note>
  Ce mode utilise bien l'endpoint `/straight/checkout-invoice/create` (payin sans redirection). Ne pas confondre avec le [payin avec redirection](/api-paiement/payin-redirect/introduction), qui utilise un endpoint distinct et expose une page de paiement multi-opérateurs.
</Note>

## UX recommandée

<Steps>
  <Step title="Collecter le numéro du client">
    Votre formulaire recueille le numéro de téléphone Orange Money Guinée.
  </Step>

  <Step title="Soumettre la requête">
    Requête sur `POST /pay/v01/straight/checkout-invoice/create` avec `customer` rempli et `otp: ""`.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Rediriger le client">
    Redirigez le navigateur du client vers cette URL. La page affiche le numéro prérempli et Orange Guinée pré-sélectionné.
  </Step>

  <Step title="Attendre le callback">
    Le résultat final arrive via votre `callback_url`. Affichez un état d'attente — ne vous fiez pas au retour navigateur.
  </Step>
</Steps>

## Exemple de requête

<CodeGroup>
  ```bash cURL theme={null}
  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": "224660000000",
          "customer_firstname": "Fatoumata",
          "customer_lastname": "Diallo",
          "customer_email": "fatoumata@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-00059"
        }
      }
    }'
  ```

  ```javascript Node.js theme={null}
  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: "Abonnement Pro — Janvier 2025",
            customer: "224660000000",
            customer_firstname: "Fatoumata",
            customer_lastname: "Diallo",
            customer_email: "fatoumata@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-00059" },
        },
      }),
    }
  );

  const data = await response.json();
  // Redirigez le client vers la page de paiement LigdiCash
  window.location.href = data.response_text;
  ```

  ```php PHP theme={null}
  $payload = [
    "commande" => [
      "invoice" => [
        "items" => [],
        "total_amount" => 5000,
        "devise" => "XOF",
        "description" => "Abonnement Pro — Janvier 2025",
        "customer" => "224660000000",
        "customer_firstname" => "Fatoumata",
        "customer_lastname" => "Diallo",
        "customer_email" => "fatoumata@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-00059"],
    ],
  ];

  $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);
  // Redirigez le client vers la page de paiement LigdiCash
  header("Location: " . $data["response_text"]);
  ```
</CodeGroup>

## Réponse attendue

```json theme={null}
{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "https://app.ligdicash.com/pay/.../checkout/...",
  "description": "",
  "custom_data": {
    "transaction_id": "ORD-2025-00059"
  },
  "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 Guinée avec le numéro prérempli.

<Warning>
  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.
</Warning>

## Limites

| Paramètre          | Valeur  |
| ------------------ | ------- |
| Montant minimum    | 200 XOF |
| Montant maximum    | --      |
| Limite quotidienne | --      |

## Pages associées

* [Modes de validation — Redirection LigdiCash](/api-paiement/payin-sans-redirect/modes-validation) — détail du flux
* [Créer une transaction](/api-paiement/payin-sans-redirect/creer-transaction) — référence complète de l'endpoint
* [Vérifier le statut](/api-paiement/payin-sans-redirect/verifier-statut) — appeler `confirm` après le callback