Référence des liens de paiement

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.

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.

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

​Types de liens

​Modes de tarification

​Statuts des liens

​Statuts des transactions

​Champs de création

​Modes des champs client

​D’où viennent les liens

​Identifiants des liens de paiement

​Développeurs

​Outils MCP

​Événements webhook