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

# Créer et partager des liens de paiement storekit

> Créez des liens de paiement storekit partageables pour encaisser des paiements ponctuels ou réutilisables auprès des clients. Envoyez-les par e-mail, SMS ou messagerie — aucune commande requise au moment du paiement.

Utilisez des liens de paiement pour encaisser des paiements en dehors du flux de commande standard. Partagez un lien par e-mail ou SMS et votre client paie directement via une page de paiement hébergée — aucune commande requise.

## Types de liens

Les liens de paiement existent en deux types :

| Type             | Description                                                                           |
| ---------------- | ------------------------------------------------------------------------------------- |
| **Ponctuel**     | Se désactive automatiquement après un seul paiement réussi                            |
| **Réutilisable** | Reste actif et accepte plusieurs paiements (éventuellement dans la limite configurée) |

## Types de montants

| Type         | Description                                                                                                  |
| ------------ | ------------------------------------------------------------------------------------------------------------ |
| **Fixe**     | Un montant défini que le client doit payer                                                                   |
| **Variable** | Le client saisit le montant au moment du paiement, éventuellement dans une plage min/max que vous configurez |

## Créer un lien de paiement

<Info>
  La section **Payments > Payment Links** n'est visible dans votre tableau de bord qu'après l'activation de storekit Payments sur votre magasin. Si vous ne la voyez pas, activez d'abord les paiements via **Store Settings > Payments > Activate Payments**. Consultez [Configurer les paiements](/docs/fr/getting-started/launch/set-up-payments) pour les instructions complètes.
</Info>

<Steps>
  <Step title="Ouvrir Payment Links">
    Allez dans **Payments > Payment Links** dans votre tableau de bord et cliquez sur **Create link**.
  </Step>

  <Step title="Configurer le lien">
    Renseignez les détails du lien :

    * **Title** — affiché au client au moment du paiement (obligatoire)
    * **Description** — contexte optionnel affiché sous le titre
    * **Reference** — une référence interne pour vos archives (par exemple un numéro de facture)
    * **Type** — ponctuel ou réutilisable
    * **Amount type** — fixe ou variable
    * **Amount** — obligatoire pour les liens à montant fixe ; saisissez dans la devise de votre magasin
    * **Min / Max amount** — bornes optionnelles pour les liens à montant variable
    * **Max payments** — plafond optionnel du nombre total de paiements pour les liens réutilisables
    * **Expiry date** — date optionnelle après laquelle le lien devient inactif
    * **Image** — image optionnelle affichée sur la page de paiement
    * **Customer details** — collectez éventuellement le nom de l'entreprise, le nom du client, l'e-mail et le téléphone au moment du paiement (voir [Collecte des informations client](#customer-detail-collection))
  </Step>

  <Step title="Configurer le comportement après paiement">
    Choisissez ce qui se passe après un paiement réussi :

    * **Thank you page** — afficher un message de remerciement personnalisable (par défaut)
    * **Redirect** — envoyer le client vers une URL de votre choix
  </Step>

  <Step title="Partager le lien">
    Une fois créé, copiez l'URL du lien ou utilisez l'option **Send** pour le transmettre par e-mail ou SMS.
  </Step>
</Steps>

## Envoyer un lien

Vous pouvez envoyer un lien de paiement directement depuis le tableau de bord :

1. Ouvrez le lien de paiement depuis **Payments > Payment Links**
2. Cliquez sur **Send**
3. Saisissez l'adresse e-mail ou le numéro de téléphone du client
4. Cliquez sur **Send link**

Le client reçoit un message contenant un lien direct vers la page de paiement.

## Statuts des liens

| Statut       | Description                                                          |
| ------------ | -------------------------------------------------------------------- |
| **Active**   | Le lien est actif et accepte les paiements                           |
| **Inactive** | Le lien a été désactivé manuellement, ou un lien ponctuel a été payé |
| **Expired**  | La date d'expiration du lien est dépassée                            |

## Désactiver un lien

Pour empêcher un lien d'accepter des paiements, ouvrez-le depuis **Payments > Payment Links** et cliquez sur **Deactivate**. Les liens désactivés renvoient un message « no longer active » à toute personne qui les visite.

## Collecte des informations client

Vous pouvez configurer un lien de paiement pour collecter des informations client au moment du paiement. Chaque champ peut être défini indépendamment sur l'un des trois modes :

| Mode       | Description                                                          |
| ---------- | -------------------------------------------------------------------- |
| `disabled` | Le champ n'est pas affiché au moment du paiement (par défaut)        |
| `optional` | Le champ est affiché mais n'est pas obligatoire                      |
| `required` | Le champ doit être rempli avant que le paiement puisse être effectué |

Les champs disponibles sont :

* **Business name** — l'entreprise du client ou le nom commercial
* **Customer name** — le nom complet du client
* **Email** — l'adresse e-mail du client
* **Phone** — le numéro de téléphone du client

Les détails collectés sont enregistrés dans chaque enregistrement de paiement et visibles dans l'onglet **Transactions**.

## Codes QR

Chaque lien de paiement dispose d'un code QR qui encode l'URL de paiement. Vous pouvez télécharger le code QR au format PNG depuis la page de détail du lien de paiement, ou le générer via l'API ou l'outil MCP `get-payment-link-qr`.

Le code QR est utile à imprimer sur des factures, des reçus ou une signalétique physique afin que les clients puissent scanner et payer directement.

## Remboursements

Vous pouvez émettre un remboursement pour tout paiement encaissé via un lien de paiement :

1. Ouvrez le lien de paiement depuis **Payments > Payment Links**
2. Allez dans l'onglet **Transactions**
3. Sélectionnez le paiement que vous souhaitez rembourser
4. Cliquez sur **Refund** et saisissez le montant

Les remboursements partiels sont pris en charge. Le statut du paiement passe à **Partially refunded** ou **Fully refunded** en conséquence.

## Consulter les transactions

Chaque lien de paiement dispose d'un onglet **Transactions** affichant tous les paiements reçus, y compris le montant, la devise, la référence du paiement et les éventuelles informations client collectées.

## Identifiants des liens de paiement

Les liens de paiement utilisent un identifiant préfixé `plink_` (par exemple, `plink_019dbc4d828174419d9ff9fae24aea7b`). Utilisez cet identifiant pour référencer un lien via l'API ou les webhooks.

## Événements webhook

storekit déclenche les événements webhook suivants pour les liens de paiement :

| Événement                       | Description                                                                         |
| ------------------------------- | ----------------------------------------------------------------------------------- |
| `payment_link.created`          | Déclenché lorsqu'un nouveau lien de paiement est créé                               |
| `payment_link.paid`             | Déclenché lorsqu'un paiement est encaissé avec succès via un lien de paiement       |
| `payment_link.refund.created`   | Déclenché lorsqu'un remboursement est initié pour un paiement par lien              |
| `payment_link.refund.succeeded` | Déclenché lorsque la passerelle de paiement confirme la réussite d'un remboursement |
| `payment_link.refund.failed`    | Déclenché lorsque la passerelle de paiement rejette un remboursement                |

Consultez [Événements webhook](/docs/fr/developers/webhooks/webhook-events) pour la référence complète des charges utiles.

## Accès API & MCP

Les liens de paiement sont disponibles via l'API storekit et les outils MCP. Vous pouvez :

* Lister les liens de paiement (filtrer par établissement, statut ou type)
* Récupérer un seul lien de paiement par son ID
* Créer un nouveau lien de paiement
* Générer un code QR pour un lien de paiement (`get-payment-link-qr`)

Consultez l'[Introduction développeur](/docs/fr/developers/introduction) pour en savoir plus sur l'accès API et MCP.


## Related topics

- [Pourboires et frais de service](/docs/fr/guides/payments/tips-service-charges.md)
- [Remboursements et versements](/docs/fr/guides/payments/refunds-payouts.md)
- [Trouver et partager l'URL de votre magasin storekit](/docs/fr/guides/store-settings/store-url.md)
- [Magasin Delivery & Pickup](/docs/fr/getting-started/store-types/delivery-pickup-store.md)
- [1. Créer votre magasin](/docs/fr/getting-started/launch/create-your-store.md)