Liens de paiement

Un lien de paiement est une page hébergée à montant fixe, à partager par WhatsApp, e-mail ou réseaux sociaux. Vous pouvez les créer depuis le tableau de bord ou par l’API.

POST/v1/payment-linksCréer un lien de paiement

Paramètre	Type	Requis	Description
`title`	string	Oui	Titre affiché au client
`amount`	number	Oui	Montant fixe
`currency`	string	Non	Par défaut, la devise de votre entreprise (Paramètres, Entreprise), sinon XOF
`description`	string	Non	Détail du produit ou service

curl -X POST https://app.nyole.com/api/v1/payment-links \
  -H "Authorization: Bearer af_live_sec_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Formation Odoo", "amount": 25000, "currency": "XOF" }'

{
  "success": true,
  "id": "cmf3lz...",
  "url": "https://app.nyole.com/pay/k3j9x2ab",
  "slug": "k3j9x2ab",
  "amount": 25000,
  "currency": "XOF"
}

GET/v1/payment-links/{id}/checkSavoir si le lien a été payé

{
  "success": true,
  "paid": true,
  "status": "SUCCESS",
  "transaction": {
    "id": "cmf3m1...",
    "amount": 25000,
    "customerName": "Awa Koné",
    "customerEmail": "[email protected]"
  }
}

Tant qu’aucun paiement n’a abouti, la réponse est { "success": true, "paid": false, "status": "WAITING" } (ou le statut de la dernière tentative). Le téléphone du client est toujours demandé sur la page, pour le Mobile Money.