Docs
ENFR
Tableau de bord
Produits

Liens de paiement

Faites-vous payer sans écrire de code : une page de paiement hébergée à partager par message, e-mail ou QR code.

Un lien de paiement ouvre une page de paiement hébergée par Monerail. Votre client choisit son pays et son opérateur mobile money, saisit son numéro et valide le paiement sur son téléphone. Aucun compte, aucune application, aucun code de votre côté. Chaque paiement par lien est un encaissement ordinaire : mêmes frais, mêmes écritures, mêmes webhooks.

Dans le tableau de bord, ouvrez Collecte, puis Créer un lien de paiement. Choisissez :

Réglage Options
Titre et description Affichés au client sur la page de paiement.
Devise Une des devises d’encaissement : XAF, XOF, GNF, CDF, GHS, KES, UGX, TZS, RWF.
Montant Fixe, ou choisi par le client avec un minimum et un maximum facultatifs.
Pays et opérateurs Tous les pays de la devise ouverts aux encaissements, ou une sélection. Avec un seul pays, vous pouvez aussi limiter les opérateurs.
Usage Réutilisable (boutique, don, cotisation) ou usage unique (facture, commande) : un lien à usage unique se ferme après son premier paiement réussi.
Expiration Jamais, 24 heures, 7 jours ou 30 jours.
Référence interne Votre numéro de commande ou de facture, renvoyé dans l’événement payment_link.paid.

Les rôles Propriétaire, Finance et Développeur peuvent créer et désactiver des liens ; tous les membres peuvent les consulter. En production, les liens sont disponibles une fois la vérification de votre entreprise validée.

Le partager

Chaque lien a une adresse courte et un QR code :

  • Production : https://monerail.com/pay/<lien>
  • Mode test : https://testmode.monerail.com/pay/<lien>, avec un bandeau Mode test sur la page. Les liens de test n’acceptent que des paiements de test : voir Tests.

Envoyez l’adresse par WhatsApp, SMS ou e-mail, ajoutez-la à vos factures, ou imprimez le QR code pour votre caisse. La page s’affiche en français ou en anglais selon le navigateur du client.

Ce que voit le client

  1. Le nom et le logo de votre entreprise (définis dans Paramètres), le titre, le montant et la description.
  2. Pays, opérateur, numéro mobile money et nom.
  3. L’opérateur demande une validation sur le téléphone (code PIN), ou envoie un code que le client saisit sur la page.
  4. La page suit le paiement en direct et affiche un reçu avec la référence dès que le paiement a réussi.

Le client ne paie aucun frais par le lien. Vos frais d’encaissement habituels s’appliquent à chaque paiement réussi.

Suivre les paiements

Dans Collecte → Liens de paiement, chaque lien affiche son statut (actif, désactivé, expiré, payé pour un lien à usage unique déjà réglé), le nombre de paiements et le montant encaissé. Ouvrez un lien pour copier son adresse, afficher son QR code, voir les paiements reçus et le désactiver. Un lien désactivé peut être réactivé ; un lien à usage unique déjà payé, non.

Les paiements apparaissent aussi avec tous vos encaissements dans Collecte et Transactions, et créditent votre solde de collecte comme n’importe quel encaissement.

Webhooks

Chaque paiement par lien envoie les événements d’encaissement habituels (collection.succeeded, collection.failed, collection.expired). L’encaissement porte metadata.payment_link et metadata.payment_link_payment, et votre référence interne dans client_reference.

Un paiement réussi envoie aussi payment_link.paid :

JSON
{
  "object": "event",
  "type": "payment_link.paid",
  "livemode": false,
  "data": {
    "object": {
      "object": "payment_link_payment",
      "id": "c41f2b7e-0d8a-4c55-9f3e-2b6a1d7e9c10",
      "payment_link": "9ea309a6-16fb-4cb1-bdea-d6632297afa4",
      "slug": "0hSaQMRKFe2L3d",
      "collection": "5a0d9116-8ef5-47ce-b7e9-7a14c2b3d001",
      "reference": "5a0d91168ef547ceb7e97a14",
      "amount": 25000,
      "fee": 625,
      "currency": "XAF",
      "title": "Commande n° 2041",
      "client_reference": "CMD-2041",
      "metadata": {},
      "reusable": true,
      "paid_count": 1
    }
  }
}

Abonnez un endpoint à payment_link.paid ou à * dans Développeurs → Webhooks. Livrez la commande à la réception de cet événement (ou de collection.succeeded), jamais au retour du client sur votre site.

Sécurité

  • La page n’affiche jamais vos coordonnées de compte, votre solde ni les autres paiements.
  • Les paiements sont limités par réseau et par lien pour bloquer les abus, et un lien à usage unique n’accepte qu’un paiement à la fois.
  • Montant, pays et opérateur sont vérifiés à nouveau par Monerail au lancement du paiement : un client ne peut pas modifier le prix d’un lien à montant fixe.