Skip to main content

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.

A LigdiCash API project groups together your authentication keys, the operators activated on your account, and your integration settings (callback URL, return URL, etc.).
You do not create your own API project. The LigdiCash technical team creates and activates your project at the end of the integration protocol — after the contract is signed, the sign-off tests are run, and the completion certificate is signed. You have no action to take on the dashboard for this step.

​
What an API project contains

ElementDescription
ApikeyKey that identifies your project in every request
API_TOKENBearer token that authenticates your requests
Activated operatorsMobile money and/or Visa operators defined in your contract
callback_urlURL where LigdiCash sends payment notifications
return_url / cancel_urlRedirect URLs after payment (hosted payin)

​
Retrieving your keys

Once your project is activated by the technical team, log in to your LigdiCash dashboard: 
https://client.ligdicash.com
Your Apikey and API_TOKEN keys are available in the API project management section.
Store your keys in environment variables rather than hardcoded in your code. This makes switching between the temporary integration account and your production account easier, with no source code changes.
LIGDICASH_API_KEY=your_apikey
LIGDICASH_AUTH_TOKEN=your_api_token

​
How to use your keys

All your requests to the LigdiCash API must include these two keys in HTTP headers: 
Apikey: {API_KEY}
Authorization: Bearer {AUTH_TOKEN}
Accept: application/json
Content-Type: application/json
See Authentication for details.

​
Integration account vs production account

During the integration phase, the technical team provides you with a temporary account with a pre-activated API project. This account is used for your integration work and your tests. When going live, you create your own LigdiCash account via the mobile app (App Store / Play Store) and the technical team activates your production project on it. Only your keys change — the code, endpoints, and request structure remain identical. See Environments for process details.

​
Modifying the project configuration

For any change to your production API project (adding an operator, changing the callback URL, etc.), contact the technical team via the Microsoft Teams group dedicated to your integration.