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.

PayLinks let you create payment pages in a few clicks from the LigdiCash dashboard. No technical integration required: you enter the product or service details and LigdiCash generates a payment URL you can share via WhatsApp, email, SMS, or social media.

​
Requirements

  • An active LigdiCash account
  • A PayLink contract signed with LigdiCash (separate from the API contract)
  • A PayLink project enabled by the LigdiCash team
The PayLink contract is separate from the payment API contract. Contact developper@ligdicash.com to enable it.
PayLinks are organized in two levels inside the dashboard: 
PayLink project "My Store"
├── PayLink "Adidas shoes — 25,000 CFA"   → paylink.ligdicash.com/adidas
├── PayLink "Customer invoice January"    → paylink.ligdicash.com/invoice-jan
└── PayLink "Association fundraiser 2024" → paylink.ligdicash.com/fundraiser-2024
A PayLink project is a container that groups your PayLinks together. Each project has its own merchant sub-account, just like an API project. A PayLink is the individual payment link tied to a product or service. From the dashboard: Merchants → Paylinks → Create a new PayLink.
FieldDescription
ProjectThe PayLink project this link belongs to
LabelName of the product or service, shown on the payment page
KeywordURL slug (paylink.ligdicash.com/{keyword}) — no spaces or accents
DescriptionLong description shown on the payment page (rich-text editor)
Descriptive imagesPhotos of the product or service

​
Payment configuration

You set a fixed amount in CFA francs. The customer cannot change it. Fits products with a single price.
The customer enters the amount they want to pay. A free-text field is shown on the payment page. Fits donations or open-amount payments.
You set a minimum amount. The customer can pay that amount or more, but not less. Fits subscriptions or contributions with a required floor.
You set a global target amount. Each customer contributes freely until the total target is reached. Fits fundraisers or group pots.

​
Other parameters

ParameterOptions
Stock managementDisabled / Enabled (caps the number of purchases)
Purchase quantityThe customer enters the quantity or not
LifetimeUnlimited / Limited (you pick a start and end date)
Post-payment actionSee below
Post-payment messageText shown to the customer after a successful payment
Callback URLURL notified after each payment (works exactly like the API callback)

​
Post-payment action

LigdiCash displays the post-payment message you set. The customer stays on the LigdiCash confirmation page.
The customer is redirected to a page on your website after payment. You enter the target URL.
The “Generate a ticket” and “File download” options appear in the interface but are not functional.

​
The generated URL

Every PayLink is reachable at: 
https://paylink.ligdicash.com/{keyword}
This URL is public and directly shareable. It opens in any browser and shows a LigdiCash payment page with the mobile money operators available under your contract.
The keyword appears in the URL — pick something short and memorable. Example: invoice-123 rather than payment-for-invoice-number-123-january-2024.

​
Callback

If you set a Callback URL, LigdiCash sends a notification to your server after every validated payment. It works exactly like the payment API callback: double request (application/x-www-form-urlencoded + application/json), same payload shape. See Callback security for the recommended re-verification pattern.

​
Payment tracking

Payments received via a PayLink appear under Merchants → Payin with the source PAYLINK. Each row shows the token, the trans_id, and a PayLink button to identify the source link. Funds are credited to the merchant sub-account of the PayLink project that matches the operator the customer used, just like any other LigdiCash payment.

​
How it differs from the payment API

Payment APIPayLinks
Technical integrationRequired (backend code)None
Payment pageHosted by LigdiCashHosted by LigdiCash
AmountDynamic (per API request)Configurable (fixed / variable / floor / fundraiser)
CallbackYesYes
AudienceDevelopersAny merchant
Required contractAPI contractPayLink contract