Paiement par lien · Guides de recettes
Envoyer un lien et suivre son règlement
Un lien à transmettre par courriel, SMS ou QR, et la lecture de son état sans attendre le client.
1. Créer le lien
expiresIn est un nombre de secondes. Passé ce délai, l'ouverture du lien mène à la page d'expiration et aucun règlement n'est possible.
{
"order": {
"reference": "CMD-2026-0142",
"amount": 5000,
"currency": "XPF"
},
"expiresIn": 86400,
"redirectUrl": "https://example.com/return",
"notificationUrl": "https://example.com/webhook"
}2. Transmettre le lien
La réponse porte l'URL à diffuser. Elle est publique et ne demande aucune authentification : ne la republiez pas sur une page indexable, un lien de paiement est nominatif par usage.
3. Suivre le règlement
Le webhook payment.captured arrive dès que le client a réglé. Entre-temps, GET /api/v1/payments/{id} donne l'état courant : c'est la lecture à faire pour afficher « en attente de règlement » sans supposer.
4. Rapprocher avec votre commande
order.reference vous revient sur le paiement et sur chaque événement. C'est la clé de rapprochement à poser dès la création : sans elle, le rapprochement repose sur le montant et la date, ce qui échoue au premier doublon.