> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercy-pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Liens de paiement

> Un lien que vous créez une fois et que n'importe quel client peut payer, autant de fois que nécessaire, sans site web ni intégration.

Une session de checkout est à usage unique : elle représente une demande de paiement précise, pour un client précis. Un **lien de paiement** fonctionne dans l'autre sens : vous le créez une fois, vous le partagez où vous voulez (WhatsApp, Instagram, votre bio), et il reste payable par autant de clients différents que nécessaire, aussi longtemps que vous le laissez actif.

Derrière chaque paiement effectué via un lien, Mercy Pay crée une session de checkout ordinaire. Rien ne change pour vos clients ni dans vos webhooks : même page de paiement, mêmes événements, mêmes frais.

> [card] [Créer un lien](https://docs.mercy-pay.com/payment-links/create-in-dashboard.md)
>
> En une minute, depuis le tableau de bord.

> [card] [Créer un lien par l'API](https://docs.mercy-pay.com/payment-links/api-guide.md)
>
> Chaque mode de prix, avec des exemples.

## Les façons de fixer le prix

Un lien de paiement peut demander un montant fixe (vous vendez un produit à 5 000 XAF, par exemple), laisser le client choisir combien il veut payer (utile pour une collecte ou un don, avec un minimum si vous voulez), proposer plusieurs tarifs, ou vendre plusieurs articles en panier. Le lien affiche toujours d'abord sa propre page, à vos couleurs, puis la page de paiement.

| `pricing_mode` | Ce que voit le client |
| - | - |
| `fixed` | Le titre, la description et le montant, puis un bouton pour payer |
| `flexible` | Un champ pour saisir le montant qu'il veut payer, au moins `minimum_amount` |
| `options` | Les tarifs proposés (`price_options`), dont il choisit un |
| `cart` | Les articles (`items`), dont il choisit les quantités |

Un lien `type: "recurring"` inscrit le client au plan choisi : il paie le premier cycle pour activer son abonnement, voir [Abonnements](https://docs.mercy-pay.com/subscriptions/overview.md).

## Pré-remplir les informations du client

Si vous connaissez déjà votre client, ajoutez ses informations à l'adresse du lien avant de la lui envoyer :

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://mercy-pay.com/payer/formation-laravel?email=awa@example.com&name=Awa%20Ndiaye&phone=%2B237677123456
```

| Paramètre | Effet |
| - | - |
| `email` | Pré-remplit l'adresse e-mail, où il reçoit son reçu |
| `name` | Pré-remplit son nom |
| `phone` | Pré-remplit son numéro mobile money, au format international (`+237…`), et choisit son pays |

Votre client peut toujours modifier ces champs, par exemple pour payer avec un autre numéro. Une valeur mal formée est simplement ignorée. Encodez les caractères spéciaux de l'adresse : `%20` pour un espace, `%2B` pour le `+`.

## Suivi

Chaque lien compte ses paiements réussis (`uses_count`) et ses ouvertures (`views_count`). Ouvrir le lien ne consomme rien : un aperçu WhatsApp ou un robot ne fait pas baisser `max_uses`. Une session de checkout en cours réserve une place jusqu'à son expiration, pour qu'un lien limité à 10 paiements n'en encaisse jamais 11.

Retrouvez les paiements d'un lien avec [`GET /api/v1/payment_links/{id}/payments`](https://docs.mercy-pay.com/api/payment-links/payments), ou recevez chacun avec `checkout_session.completed`, qui porte le lien d'origine et les réponses du payeur.

## Désactiver un lien

Un lien désactivé affiche une page "indisponible" à qui le visite, mais son historique (paiements déjà reçus, compteur d'utilisations) reste intact. Contrairement à une suppression, une désactivation se défait. Un lien peut aussi expirer de lui-même si vous lui donnez une date d'expiration à la création.

Voir [Créer un lien de paiement](https://docs.mercy-pay.com/payment-links/create-in-dashboard.md) pour le parcours dans le tableau de bord, [Créer un lien par l'API](https://docs.mercy-pay.com/payment-links/api-guide.md) pour le flux développeur, ou [Liens de paiement](https://docs.mercy-pay.com/api/payment-links/create.md) pour la référence API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.