Skip to main content
Le webhook est le canal principal de notification, mais vous devez pouvoir vérifier un paiement à la demande : pour confirmer un webhook, rattraper une notification perdue, ou afficher l’état d’une commande.

Statut d’un paiement

GET /web-merchant/payment/status renvoie le statut courant à partir de la référence PAY….
Cet endpoint utilise le jeton marchand (authenticationtoken), pas la clé API. Voir Authentification pour obtenir un jeton depuis votre backend.

Obtenir et conserver un jeton côté serveur

Lister et rechercher les paiements

Pour un rapprochement en masse (fin de journée, réconciliation comptable), utilisez la recherche filtrée :
Filtres disponibles : date_min, date_max, reference (recherche partielle sur PAY… ou order_id), status, operator, country. Détails sur GET /web-merchant/payments/search. Pour un export fichier (Excel, PDF, CSV) avec les mêmes filtres : GET /web-merchant/payments/export.

Stratégie recommandée

  1. Le webhook déclenche, la vérification confirme : ne marquez jamais une commande payée sur la seule foi d’un webhook non vérifié.
  2. Rattrapage : un job périodique (toutes les 15 minutes) qui liste vos commandes PENDING de plus de 5 minutes et interroge leur statut couvre les cas de webhook perdu.
  3. Expiration : après 24 heures, un paiement non effectué est FAILED. Fermez la commande ou proposez un nouveau lien.