Relancer un lien impayé

Un lien périmé ne se prolonge pas : on en crée un nouveau, et on ferme l'ancien fil.

1. Constater l'impayé

Lisez le paiement. Tant qu'aucun règlement n'a eu lieu, il n'est ni authorized ni captured : c'est le signal de relance.

get/api/v1/payments/{id}

{
  "id": "pay_2NjK8mLk0093xY",
  "status": "pending",
  "order": { "reference": "CMD-2026-0142", "amount": 5000, "currency": "XPF" }
}

2. Créer un lien de remplacement

Reprenez la même order.reference. Deux paiements porteront alors la même référence, et c'est voulu : la référence désigne votre commande, pas la tentative de règlement.

L'idempotence protège du double envoi, pas de la relance

Une clé d'idempotence réutilisée rejoue la première réponse au lieu de créer un second lien. Pour une relance, il faut donc une clé neuve — c'est bien un nouveau lien que vous demandez.

3. Fermer l'ancien fil

Rien n'annule un lien à distance ; il expire. Côté vous, cessez d'attendre son webhook et rattachez la commande au nouveau paiement, sans quoi un règlement tardif sur l'ancien lien serait compté deux fois.