Créer une facture payin redirect

Crée une facture de paiement avec redirection et retourne l’URL de la page de paiement LigdiCash.

POST /pay/v01/redirect/checkout-invoice/create

Créer une facture payin redirect

cURL

curl --request POST \
  --url https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/create \
  --header 'Accept: <accept>' \
  --header 'Apikey: <apikey>' \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "commande": {
    "invoice": {
      "items": [
        {
          "name": "<string>",
          "description": "<string>",
          "quantity": 123,
          "unit_price": 123,
          "total_price": 123
        }
      ],
      "total_amount": 123,
      "devise": "<string>",
      "description": "<string>",
      "customer": "<string>",
      "customer_firstname": "<string>",
      "customer_lastname": "<string>",
      "customer_email": "<string>",
      "external_id": "<string>",
      "otp": "<string>"
    },
    "store": {
      "name": "<string>",
      "website_url": "<string>"
    },
    "actions": {
      "cancel_url": "<string>",
      "return_url": "<string>",
      "callback_url": "<string>"
    },
    "custom_data": {}
  }
}
'

200

{
  "response_code": "<string>",
  "token": "<string>",
  "response_text": "<string>",
  "wiki": "<string>"
}

​

En-têtes

Apikey · string · requis

Clé API du projet LigdiCash.

Authorization · string · requis

Bearer {API_TOKEN}

Accept · string · requis

application/json

Content-Type · string · requis

application/json

​

Corps

commande · object · requis

Masquer commande

invoice · object · requis

Masquer invoice

items · array · requis

Articles de la commande. Peut être [] — dans ce cas seul total_amount est utilisé.

Afficher item

name · string · requis

Nom de l’article.

description · string

Description.

quantity · integer · requis

Quantité.

unit_price · integer · requis

Prix unitaire en XOF.

total_price · integer · requis

unit_price × quantity en XOF.

total_amount · integer · requis

Montant total en XOF (entier).

devise · string · requis

Toujours "XOF".

description · string · requis

Description affichée sur la page de paiement.

customer · string · requis

Toujours "". Un numéro non vide filtre les opérateurs affichés.

customer_firstname · string

Prénom du client.

customer_lastname · string

Nom du client.

customer_email · string

Email du client.

external_id · string

Identifiant marchand alternatif. "" si non utilisé.

otp · string

Toujours "".

store · object · requis

Masquer store

name · string · requis

Nom de la boutique affiché sur la page de paiement.

website_url · string · requis

URL du site marchand.

actions · object · requis

Masquer actions

cancel_url · string · requis

URL de redirection si le client annule.

return_url · string · requis

URL de redirection après paiement réussi.

callback_url · string · requis

URL de notification backend. Doit être accessible publiquement.

custom_data · object

Métadonnées libres retournées dans le callback. Recommandé : inclure un transaction_id unique.

​

Réponse

response_code · string

"00" = succès, "01" = erreur.

token · string

Token de la transaction. À stocker immédiatement — requis pour appeler confirm.

response_text · string

Succès : URL de la page de paiement à ouvrir pour le client. Échec : sous-code Echec (CodeXX).

wiki · string

URL de la documentation des sous-codes pour cet endpoint.

Succès

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

​

Codes d’erreur

Wiki : https://client.ligdicash.com/wiki/createInvoice — voir Sous-codes par endpoint.

​

Guide associé

Créer une facture — exemples complets et pièges à éviter.