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

> Générez des liens de paiement depuis le dashboard LigdiCash, sans code ni intégration technique. Idéal pour les marchands sans site web.

Les PayLinks vous permettent de créer des pages de paiement en quelques clics depuis le dashboard LigdiCash. Aucune intégration technique n'est requise : vous renseignez les informations du produit ou du service, et LigdiCash génère une URL de paiement que vous pouvez partager par WhatsApp, email, SMS ou réseaux sociaux.

## Prérequis

* Un compte LigdiCash actif
* Un **contrat PayLink** signé avec LigdiCash (distinct du contrat API)
* Un **projet PayLink** activé par l'équipe LigdiCash

<Note>
  Le contrat PayLink est séparé du contrat API de paiement. Contactez [developper@ligdicash.com](mailto:developper@ligdicash.com) pour l'activer.
</Note>

## Structure : projets et PayLinks

Les PayLinks sont organisés en deux niveaux dans le dashboard :

```
Projet PayLink "Ma Boutique"
├── PayLink "Chaussures Adidas — 25 000 XOF"  → paylink.ligdicash.com/adidas
├── PayLink "Facture client janvier"           → paylink.ligdicash.com/facture-jan
└── PayLink "Collecte association 2024"        → paylink.ligdicash.com/collecte-2024
```

Un **projet PayLink** est un container qui regroupe vos PayLinks. Chaque projet dispose de son propre sous-compte marchand, comme un projet API.

Un **PayLink** est le lien de paiement individuel, associé à un produit ou un service.

## Créer un PayLink

Depuis le dashboard : **Marchands → Paylinks → Créer un nouveau PayLink**.

### Détails du PayLink

| Champ                   | Description                                                                 |
| ----------------------- | --------------------------------------------------------------------------- |
| **Projet**              | Le projet PayLink auquel ce lien est rattaché                               |
| **Libellé**             | Nom du produit ou du service, affiché sur la page de paiement               |
| **Mot-clé**             | Slug de l'URL (`paylink.ligdicash.com/{mot-clé}`) — sans espaces ni accents |
| **Description**         | Description longue affichée sur la page de paiement (éditeur enrichi)       |
| **Images descriptives** | Photos du produit ou du service                                             |

### Configuration du paiement

<AccordionGroup>
  <Accordion title="Prix fixe">
    Vous définissez un montant fixe en XOF. Le client ne peut pas le modifier. Adapté aux produits à prix unique.
  </Accordion>

  <Accordion title="Prix variable">
    Le client saisit lui-même le montant qu'il souhaite payer. Un champ libre s'affiche sur la page de paiement. Adapté aux dons ou aux paiements à montant libre.
  </Accordion>

  <Accordion title="Prix plancher">
    Vous définissez un montant minimum. Le client peut payer ce montant ou davantage, mais pas moins. Adapté aux abonnements ou contributions avec minimum obligatoire.
  </Accordion>

  <Accordion title="Collecte">
    Vous définissez un objectif de montant global. Chaque client contribue librement jusqu'à ce que l'objectif total soit atteint. Adapté aux levées de fonds ou aux cagnottes.
  </Accordion>
</AccordionGroup>

### Autres paramètres

| Paramètre                 | Options                                                                                                             |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Gestion du stock**      | Sans gestion / Avec gestion (limite le nombre d'achats)                                                             |
| **Quantité achetée**      | Le client saisit la quantité ou non                                                                                 |
| **Durée de vie**          | Illimitée / Limitée (vous choisissez une date de début et de fin)                                                   |
| **Action post-paiement**  | Voir ci-dessous                                                                                                     |
| **Message post-paiement** | Texte affiché au client après le paiement réussi                                                                    |
| **Callback URL**          | URL notifiée après chaque paiement (même fonctionnement que le [callback API](/api-paiement/callback/introduction)) |

### Action post-paiement

<AccordionGroup>
  <Accordion title="Ne rien faire">
    LigdiCash affiche le message post-paiement que vous avez saisi. Le client reste sur la page de confirmation LigdiCash.
  </Accordion>

  <Accordion title="Redirection vers une URL">
    Le client est redirigé vers une page de votre site après le paiement. Vous saisissez l'URL cible.
  </Accordion>
</AccordionGroup>

<Note>
  Les options « Générer un ticket » et « Téléchargement de fichier » existent dans l'interface mais ne sont pas fonctionnelles.
</Note>

## L'URL générée

Chaque PayLink est accessible à l'adresse :

```
https://paylink.ligdicash.com/{mot-clé}
```

Cette URL est publique et partageable directement. Elle s'ouvre dans n'importe quel navigateur et affiche une page de paiement LigdiCash avec les opérateurs mobile money disponibles selon votre contrat.

<Tip>
  Le mot-clé apparaît dans l'URL — choisissez-le court et mémorable. Exemple : `facture-123` plutôt que `paiement-de-la-facture-numero-123-janvier-2024`.
</Tip>

## Callback

Si vous renseignez une Callback URL, LigdiCash envoie une notification à votre serveur après chaque paiement validé. Le fonctionnement est identique au callback de l'API de paiement : double requête (`application/x-www-form-urlencoded` + `application/json`), même structure de payload.

Consultez la section [Sécurisation du callback](/api-paiement/callback/securisation) pour le pattern de re-vérification recommandé.

## Suivi des paiements

Les paiements reçus via un PayLink apparaissent dans **Marchands → Payin** avec la source `PAYLINK`. Chaque ligne affiche le token, le `trans_id` et un bouton **PayLink** pour identifier le lien d'origine.

Les fonds sont crédités sur le sous-compte marchand du projet PayLink correspondant à l'opérateur utilisé par le client, comme pour tout paiement LigdiCash.

## Différence avec l'API de paiement

|                       | API de paiement             | PayLinks                                             |
| --------------------- | --------------------------- | ---------------------------------------------------- |
| Intégration technique | Requise (code backend)      | Aucune                                               |
| Page de paiement      | Hébergée par LigdiCash      | Hébergée par LigdiCash                               |
| Montant               | Dynamique (par requête API) | Configurable (fixe / variable / plancher / collecte) |
| Callback              | Oui                         | Oui                                                  |
| Public cible          | Développeurs                | Tout marchand                                        |
| Contrat requis        | Contrat API                 | Contrat PayLink                                      |