Skip to main content
Ce guide couvre le flux complet d’un encaissement, du montant jusqu’à la confirmation sur votre serveur, avec la page hébergée : la manière la plus rapide de démarrer. Si vous préférez ne jamais rediriger votre client vers une page Mercy Pay, la charge directe fait la même chose depuis votre propre formulaire : votre serveur appelle POST /api/v1/payments avec le numéro et l’opérateur du client. Elle ne couvre que le mobile money pour l’instant, voir Paiements.
1

Créez la session côté serveur

Ne créez jamais de session depuis le navigateur : votre clé API ne doit pas y figurer.
Stockez reference dans votre commande.
2

Redirigez votre client

Envoyez le client vers data.checkout_url. Sur la page hébergée, il choisit son moyen de paiement :
  • Mobile money : pays, opérateur et numéro, parmi tous les pays disponibles. Même si leur devise diffère de celle de la session, le montant est alors converti automatiquement : voir Sessions de checkout.
  • Carte bancaire : disponible si le montant atteint le minimum de la devise, voir Montants et devises.
3

Attendez la confirmation par webhook

La redirection vers success_url ne prouve rien. Le client peut fermer l’onglet avant qu’elle n’ait lieu. Ne marquez une commande payée qu’à réception de payment.succeeded, voir Gérer les webhooks.
4

Relisez la session si besoin

Pour vérifier l’état à tout moment :
Le champ status passe de created à pending_payment, puis completed.

​
Erreurs fréquentes