Passer au contenu principal
Cet endpoint crée une nouvelle facture de paiement et retourne un lien vers la page de paiement LigdiCash. C’est la première étape du flux payin avec redirection. 
POST https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/create

​
Headers

​
Apikey
string
requis
La clé API de votre projet LigdiCash.
​
Authorization
string
requis
Votre API TOKEN précédé de Bearer . Exemple : Bearer eyJ0eXAiOiJKV1Qi...
​
Accept
string
requis
Doit être application/json.
​
Content-Type
string
requis
Doit être application/json.

​
Body

​
commande
object
requis
Objet racine de la requête.

​
Exemple de requête

curl -X POST https://app.ligdicash.com/pay/v01/redirect/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": [
          {
            "name": "Abonnement Pro",
            "description": "Accès premium 1 mois",
            "quantity": 1,
            "unit_price": 5000,
            "total_price": 5000
          }
        ],
        "total_amount": 5000,
        "devise": "XOF",
        "description": "Abonnement Pro — Janvier 2025",
        "customer": "",
        "customer_firstname": "Amadou",
        "customer_lastname": "Diallo",
        "customer_email": "amadou@exemple.com",
        "external_id": "",
        "otp": ""
      },
      "store": {
        "name": "MonApp",
        "website_url": "https://monapp.com"
      },
      "actions": {
        "cancel_url": "https://monapp.com/paiement/annule",
        "return_url": "https://monapp.com/paiement/succes",
        "callback_url": "https://monapp.com/api/callback/ligdicash"
      },
      "custom_data": {
        "transaction_id": "ORD-2025-00042"
      }
    }
  }'

const response = await fetch(
  "https://app.ligdicash.com/pay/v01/redirect/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: [
            {
              name: "Abonnement Pro",
              description: "Accès premium 1 mois",
              quantity: 1,
              unit_price: 5000,
              total_price: 5000,
            },
          ],
          total_amount: 5000,
          devise: "XOF",
          description: "Abonnement Pro — Janvier 2025",
          customer: "",
          customer_firstname: "Amadou",
          customer_lastname: "Diallo",
          customer_email: "amadou@exemple.com",
          external_id: "",
          otp: "",
        },
        store: { name: "MonApp", website_url: "https://monapp.com" },
        actions: {
          cancel_url: "https://monapp.com/paiement/annule",
          return_url: "https://monapp.com/paiement/succes",
          callback_url: "https://monapp.com/api/callback/ligdicash",
        },
        custom_data: { transaction_id: "ORD-2025-00042" },
      },
    }),
  }
);

const data = await response.json();

$payload = [
  "commande" => [
    "invoice" => [
      "items" => [[
        "name" => "Abonnement Pro",
        "description" => "Accès premium 1 mois",
        "quantity" => 1,
        "unit_price" => 5000,
        "total_price" => 5000,
      ]],
      "total_amount" => 5000,
      "devise" => "XOF",
      "description" => "Abonnement Pro — Janvier 2025",
      "customer" => "",
      "customer_firstname" => "Amadou",
      "customer_lastname" => "Diallo",
      "customer_email" => "amadou@exemple.com",
      "external_id" => "",
      "otp" => "",
    ],
    "store" => ["name" => "MonApp", "website_url" => "https://monapp.com"],
    "actions" => [
      "cancel_url" => "https://monapp.com/paiement/annule",
      "return_url" => "https://monapp.com/paiement/succes",
      "callback_url" => "https://monapp.com/api/callback/ligdicash",
    ],
    "custom_data" => ["transaction_id" => "ORD-2025-00042"],
  ],
];

$ch = curl_init("https://app.ligdicash.com/pay/v01/redirect/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);

​
Réponse

​
response_code
string
"00" si la facture a été créée avec succès, "01" en cas d’erreur.
​
token
string
Identifiant de la transaction côté LigdiCash. À stocker en base — nécessaire pour appeler confirm.
​
response_text
string
En cas de succès : l’URL de la page de paiement à ouvrir pour le client. En cas d’échec : le sous-code d’erreur au format Echec (CodeXX).
​
wiki
string
URL vers la documentation des codes d’erreur de cet endpoint. À consulter quand response_code vaut "01".

​
Exemple de réponse

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "https://app.ligdicash.com/pay/invoice/eyJ0eXAiOiJKV1Qi...",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

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

​
Pages associées