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