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

# Référence des liens de paiement

> Référence des liens de paiement storekit : types, tarification, statuts, champs de création, modes des champs client, identifiants, outils MCP et webhooks.

Recherche rapide des termes utilisés dans les guides sur les liens de paiement. Pour le détail des procédures, suivez les liens de chaque section.

## Types de liens

| Libellé du tableau de bord | Comportement | Valeur API |
| - | - | - |
| **One-off** | Se ferme après un paiement réussi | `one_off` |
| **Reusable** | Reste ouvert jusqu'à ce qu'il soit désactivé, expiré ou que le plafond de paiements soit atteint | `reusable` |

Figé à la création.

## Modes de tarification

| Libellé du tableau de bord | Comportement | Valeur API |
| - | - | - |
| **Set price** | Le client paie le **Price** que vous saisissez | `fixed` |
| **Customer chooses** | Le client saisit un montant, éventuellement entre **Minimum** et **Maximum** | `variable` |

Figé à la création. **Minimum** et **Maximum** peuvent être modifiés ensuite.

## Statuts des liens

| Statut | Comment un lien y arrive | Peut-il être changé ? |
| - | - | - |
| **Active** | Créé, ou réactivé via **Activate** | **Deactivate** |
| **Inactive** | **Deactivate** | **Activate** |
| **Expired** | **Link expiry date** dépassée | Non, créez un nouveau lien |
| **Completed** | Lien one-off payé, ou lien reusable ayant atteint son **Maximum number of payments** | Non, créez un nouveau lien |

Détails dans [Gérer les liens de paiement](/docs/fr/payment-links/managing-payment-links#statuts).

## Statuts des transactions

| Statut | Signification | Remboursable ? |
| - | - | - |
| **Pending** | Paiement démarré, pas encore confirmé | Non |
| **Paid** | Paiement réussi | Oui |
| **Partial Refund** | Une partie du paiement remboursée | Oui, jusqu'à **Max refundable** |
| **Refunded** | Entièrement remboursé | Non |

Détails dans [Remboursements et transactions](/docs/fr/payment-links/refunds-and-transactions).

## Champs de création

Libellés tels qu'affichés sur la page **New Payment Link**. La page de détail utilise des libellés plus courts pour les mêmes champs, indiqués entre parenthèses lorsqu'ils diffèrent.

| Champ | Obligatoire | Modifiable ensuite |
| - | - | - |
| **Store** | Oui | Non |
| **Title** | Oui | Oui |
| **Description shown to the customer** (**Description**) | Non | Oui |
| **Link type** (**Link Type**) | Oui | Non |
| **Pricing** (**Amount Type**) | Oui | Non |
| **Price** | Avec **Set price** | Non |
| **Minimum** / **Maximum** (**Min Amount** / **Max Amount**) | Non | Oui |
| **Image** | Non | Oui |
| **Customer fields** — **Name**, **Email**, **Phone**, **Business name** | Non | Oui |
| **Reference** | Non | Oui |
| **Link expiry date** (**Expiry Date**) | Non | Oui |
| **Maximum number of payments** (**Max Payments**) | Non, reusable uniquement | Oui |
| **After successful payment** (**After Payment**) | Oui, valeur par défaut **Show thank you** | Oui |
| **Custom thank you message** (**Success Message**) | Non | Oui |
| **Redirect URL after payment** (**Redirect URL**) | Avec **Redirect to URL** | Oui |

### Modes des champs client

| Libellé du tableau de bord | Comportement sur la page de paiement | Valeur API |
| - | - | - |
| **Off** | Champ non affiché | `disabled` |
| **Optional** | Affiché, marqué *optional* | `optional` |
| **Required** | Affiché, doit être renseigné pour payer | `required` |

Les quatre champs correspondent à `collectCustomerName`, `collectEmail`, `collectPhone` et `collectBusinessName`.

## D'où viennent les liens

La page de détail affiche **Created via** pour chaque lien :

| Valeur | Créé par |
| - | - |
| `dashboard` | **Payment Links** → **Create Payment Link** |
| `order` | L'invite **Send Payment Link** sur une commande. Consultez [Encaisser le paiement d'une commande impayée](/docs/fr/payment-links/collecting-for-an-order) |
| `mcp` | Un assistant IA connecté via storekit MCP |
| `api` | Intégration API directe |

## Identifiants des liens de paiement

Chaque lien de paiement a un identifiant préfixé `plink_`, par exemple `plink_019dbc4d828174419d9ff9fae24aea7b`. Il apparaît dans l'URL du tableau de bord lorsque le lien est ouvert, dans les réponses des outils MCP et dans les payloads webhook, et il constitue la dernière partie de l'URL vue par le client : `https://<votre domaine de commande>/pay/plink_…`.

## Développeurs

### Outils MCP

Les assistants IA connectés utilisent ces outils. Consultez [Outils MCP](/docs/fr/developers/mcp/tools) pour les paramètres.

| Outil | Type |
| - | - |
| `list-payment-links` | Lecture |
| `get-payment-link` | Lecture |
| `create-payment-link` | Écriture. L'assistant demande une approbation sauf si vous l'avez auto-autorisé |
| `get-payment-link-qr` | Lecture. Renvoie un PNG |

### Événements webhook

| Événement | Déclenché quand |
| - | - |
| `payment_link.created` | Un lien de paiement est créé |
| `payment_link.paid` | Un paiement est encaissé via un lien |
| `payment_link.refund.created` | Un remboursement est demandé |
| `payment_link.refund.succeeded` | La passerelle de paiement confirme le remboursement |
| `payment_link.refund.failed` | La passerelle de paiement rejette le remboursement |

Les payloads sont documentés dans [Événements webhook](/docs/fr/developers/webhooks/webhook-events#payments-events).


## Related topics

- [Remboursements et transactions des liens de paiement](/docs/fr/payment-links/refunds-and-transactions.md)
- [Gérer les liens de paiement](/docs/fr/payment-links/managing-payment-links.md)
- [Vue d'ensemble des liens de paiement](/docs/fr/payment-links/overview.md)
- [Créer un lien de paiement](/docs/fr/payment-links/creating-a-payment-link.md)
- [Partager un lien de paiement](/docs/fr/payment-links/sharing-a-payment-link.md)


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