Paiements

Payment Links

Encaissez sans integration : un lien, un checkout heberge, une confirmation.

Endpoints

POST/v1/payment-linksCreer un liencle secrete

GET/v1/payment-linksLister les lienscle publique ou secrete

GET/v1/payment-links/:idRecuperer un liencle publique ou secrete

POST/v1/payment-links/:idModifier un liencle secrete

GET/v1/payment-links/:id/paymentsPaiements issus du liencle publique ou secrete

Creer un lien

{
  "title": "Formation WanePay — Session de mars",
  "description": "Acces a la formation en ligne, support inclus.",
  "amount": 25000,
  "currency": "XOF",
  "country": "TG",
  "reference": "FORMATION-MARS",
  "allowed_methods": ["mobile_money", "card"],
  "max_payments": 50,
  "collect_customer": true,
  "redirect_url": "https://mon-site.com/merci",
  "expires_at": "2024-04-30T23: 59: 59.000Z"
}

Parametres

Parametre	Type	Description
`title`requis	string	Titre affiche au client.
`description`	string	Detail du produit ou du service.
`amount`	integer	Montant fixe. Omis, le client saisit librement le montant.
`currency`requis	string	Devise du lien.
`country`requis	string	Pays determinant les moyens proposes.
`allowed_methods`	string[]	Restreint les moyens proposes. Vide = tous ceux disponibles.
`max_payments`	integer	Nombre maximum de paiements acceptes.
`collect_customer`	boolean	Demander nom et email au client (defaut true).
`redirect_url`	string	Redirection apres paiement reussi.
`expires_at`	string	Date ISO-8601 d’expiration.

Comportement du checkout

Le checkout n’affiche que les moyens de paiement reellement disponibles pour le pays et la devise du lien, en fonction des connexions actives. Un lien devient impayable lorsqu’il est desactive, expire, ou que son quota est atteint.

Le compteur de paiements n’est incremente qu’au succes de la transaction.
Chaque paiement issu du lien porte payment_link_id : la reconciliation est immediate.
Un evenement payment_link.paid est emis en plus de payment.succeeded.

En sandbox, le checkout affiche un bandeau explicite et propose de simuler la validation ou le refus du client. Aucun paiement reel n’est effectue.