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

# Créer un lien de paiement

> Un lien que vous créez une fois et partagez n'importe où, payable par autant de clients que nécessaire.

Ce guide couvre la création d'un lien de paiement réutilisable : la manière la plus rapide d'encaisser sans construire de session pour chaque client. Voir [Liens de paiement](/concepts/payment-links) pour le fonctionnement général.

<Steps>
  <Step title="Créez le lien">
    Laissez `amount` de côté si vous voulez que le client choisisse combien payer, utile pour un don ou une collecte. Fixez-le pour vendre à prix fixe.

    ```bash theme={null}
    curl https://mercy-pay.com/api/v1/payment-links \
      -H "Authorization: Bearer mp_live_XXXXXXXXXXXXXXXX" \
      -H "Content-Type: application/json" \
      -d '{
        "title": "Collecte caritative",
        "currency": "XAF",
        "minimum_amount": 500
      }'
    ```

    La réponse contient `url` : c'est le lien à partager tel quel, pas besoin de le transformer.
  </Step>

  <Step title="Partagez-le">
    N'importe où : WhatsApp, Instagram, un lien en bio, un SMS. Chaque personne qui l'ouvre peut payer indépendamment des autres. Rien à créer de votre côté pour chaque client.
  </Step>

  <Step title="Suivez les paiements comme d'habitude">
    Chaque paiement effectué via le lien déclenche les mêmes webhooks qu'un paiement classique (`payment.succeeded`, `payment.failed`), et apparaît dans `GET /api/v1/payments` avec la référence de sa session. Voir [Gérer les webhooks](/guides/handle-webhooks).
  </Step>

  <Step title="Désactivez-le quand vous n'en avez plus besoin">
    Un lien désactivé refuse les nouveaux paiements mais garde son historique. La désactivation se fait depuis votre tableau de bord, pas par l'API pour l'instant.
  </Step>
</Steps>

## Erreurs fréquentes

| Message | Cause |
| - | - |
| `Ce lien n'est plus disponible.` | Lien désactivé, expiré, ou slug incorrect |
| Erreur de validation sur `amount` | Montant sous le `minimum_amount` fixé à la création |


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