> ## 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

> Generate payment links from the LigdiCash dashboard with no code or technical integration. Built for merchants without a website.

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

<Note>
  The PayLink contract is separate from the payment API contract. Contact [developper@ligdicash.com](mailto:developper@ligdicash.com) to enable it.
</Note>

## Structure: projects and PayLinks

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.

## Create a PayLink

From the dashboard: **Merchants → Paylinks → Create a new PayLink**.

### PayLink details

| Field                  | Description                                                         |
| ---------------------- | ------------------------------------------------------------------- |
| **Project**            | The PayLink project this link belongs to                            |
| **Label**              | Name of the product or service, shown on the payment page           |
| **Keyword**            | URL slug (`paylink.ligdicash.com/{keyword}`) — no spaces or accents |
| **Description**        | Long description shown on the payment page (rich-text editor)       |
| **Descriptive images** | Photos of the product or service                                    |

### Payment configuration

<AccordionGroup>
  <Accordion title="Fixed price">
    You set a fixed amount in CFA francs. The customer cannot change it. Fits products with a single price.
  </Accordion>

  <Accordion title="Variable 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.
  </Accordion>

  <Accordion title="Minimum price">
    You set a minimum amount. The customer can pay that amount or more, but not less. Fits subscriptions or contributions with a required floor.
  </Accordion>

  <Accordion title="Fundraiser">
    You set a global target amount. Each customer contributes freely until the total target is reached. Fits fundraisers or group pots.
  </Accordion>
</AccordionGroup>

### Other parameters

| Parameter                | Options                                                                                                        |
| ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| **Stock management**     | Disabled / Enabled (caps the number of purchases)                                                              |
| **Purchase quantity**    | The customer enters the quantity or not                                                                        |
| **Lifetime**             | Unlimited / Limited (you pick a start and end date)                                                            |
| **Post-payment action**  | See below                                                                                                      |
| **Post-payment message** | Text shown to the customer after a successful payment                                                          |
| **Callback URL**         | URL notified after each payment (works exactly like the [API callback](/en/payment-api/callback/introduction)) |

### Post-payment action

<AccordionGroup>
  <Accordion title="Do nothing">
    LigdiCash displays the post-payment message you set. The customer stays on the LigdiCash confirmation page.
  </Accordion>

  <Accordion title="Redirect to a URL">
    The customer is redirected to a page on your website after payment. You enter the target URL.
  </Accordion>
</AccordionGroup>

<Note>
  The "Generate a ticket" and "File download" options appear in the interface but are not functional.
</Note>

## 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.

<Tip>
  The keyword appears in the URL — pick something short and memorable. Example: `invoice-123` rather than `payment-for-invoice-number-123-january-2024`.
</Tip>

## 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](/en/payment-api/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 API               | PayLinks                                             |
| --------------------- | ------------------------- | ---------------------------------------------------- |
| Technical integration | Required (backend code)   | None                                                 |
| Payment page          | Hosted by LigdiCash       | Hosted by LigdiCash                                  |
| Amount                | Dynamic (per API request) | Configurable (fixed / variable / floor / fundraiser) |
| Callback              | Yes                       | Yes                                                  |
| Audience              | Developers                | Any merchant                                         |
| Required contract     | API contract              | PayLink contract                                     |