Liens de paiement

Résumé

Cette page résume la version anglaise ; certaines étapes n’y figurent pas. Version complète : la page en anglais.

Créez un lien avec POST /v1/payment-links, le corps PaymentLinkCreate et une clé d’idempotence. Un lien demande un montant fixe, ou un montant libre que le payeur choisit, éventuellement entre un minimum et un maximum, en unités mineures d’une seule devise (francs entiers pour le CDF). Il sert une fois ou plusieurs fois, et reste payable pendant expires_in_hours heures (de 1 à 720), calculées par le serveur. Créer un lien ne crée aucun paiement. Une return_url, facultative, est une URL https absolue que chaque paiement du lien reprend, sans rien y ajouter et sans jamais prouver un paiement ; un lien ne prend aucun embedding, si bien que ses pages ne s’affichent jamais dans un cadre.

Le code LK-XXXX-XXXX nomme le lien ; il ne permet pas de payer. Les listes et détails ne contiennent jamais l’URL de partage : elle s’obtient avec payments:write et doit rester hors des journaux et caches partagés. Chaque tentative du payeur est un paiement ordinaire lié aux conditions du lien. Un lien à usage unique n’a qu’une tentative ouverte, en cours ou approuvée ; un refus le libère pour un nouvel essai.

L’annulation est possible tant que le lien n’est ni payé ni expiré et qu’aucune tentative n’est en cours. Elle ne déplace aucun fonds. Le portail propose copie, QR local et liens vers vos applications SMS/WhatsApp : vous choisissez le destinataire et confirmez l’envoi. Aucun message réel ni paiement réel n’est réalisé par cette version de test.