DocsTableau de bord

Liens de paiement

Modifier un lien

PATCH/v1/payment-links/{id}payments:write

Autorisation payments:write. Remplace le lien entier, comme à la création : titre, montant fixe ou bornes, usage, expiration, moyens (absents : tous). Sa devise et son adresse restent. Un paiement déjà ouvert garde son montant ; les sessions suivantes prennent le nouveau.

En-têtes

AuthorizationBearer pos_key_…obligatoire
Clé de serveur, pour tout l’espace. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire
L’espace marchand concerné (mrc_…).

Paramètres

iddans le cheminobligatoire

Corps

titlestring, 1 à 80obligatoire
Montré à l’acheteur.
amount_minorstring
En centimes.
min_minorstring
En centimes.
max_minorstring
En centimes.
reusablebooleanobligatoire
false : le lien se ferme après le premier paiement réussi.
expires_atstring ou null
connection_idsliste de string
Les connexions que le lien propose, dont une au moins prend la carte. Absent ou vide : toutes, comme d’habitude.

Réponses

200Réussi
400Requête invalide
401Clé absente ou invalide
403Autorisation ou espace refusé
404Ressource introuvable
409Conflit avec une demande existante
429Trop de demandes, réessayez plus tard
503Service momentanément indisponible

Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.