Créer une transaction payin sans redirect

Initie un paiement mobile money directement depuis votre interface, sans redirection vers une page LigdiCash.

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

Créer une transaction payin sans redirect

cURL

curl --request POST \
  --url https://app.ligdicash.com/pay/v01/straight/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>"
}

Le Wallet LigdiCash utilise des endpoints distincts (/v02). Voir GET /pay/v02/debitotp et POST /pay/v02/debitwallet/withotp.

​

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. Peut être [] — total_amount fait foi.

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 de la commande.

customer · string · requis

Numéro mobile money du client. Format : 22670XXXXXXX (sans + ni espaces).

customer_firstname · string

Prénom du client.

customer_lastname · string

Nom du client.

customer_email · string

Email du client.

external_id · string · requis

Toujours "".

otp · string · requis

OTP selon le mode de l’opérateur : OTP USSD → valeur ; USSD Push / Approbation / 1ère requête OTP SMS → "" ; 2ème requête OTP SMS → OTP reçu par SMS.

store · object · requis

Masquer store

name · string · requis

Nom de la boutique.

website_url · string · requis

URL du site marchand.

actions · object · requis

Masquer actions

cancel_url · string · requis

Toujours "".

return_url · string · requis

Toujours "".

callback_url · string · requis

URL de notification backend. 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 confirm.

response_text · string

Succès : "Votre requête est en cours de traitement". Échec : Echec (CodeXX).

wiki · string

URL de la documentation des sous-codes.

Succès

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

​

Codes d’erreur

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

​

Guides associés

• Créer une transaction — exemples par mode OTP
• Modes de validation — OTP USSD, OTP SMS, Approbation