Gérer les paiements dans QryptoPay

Chaque paiement dans QryptoPay a sa propre fiche, la boîte de dialogue « Détails du paiement sur la blockchain ». Ouvrez le marchand, allez sur l’onglet « Paiements », placez le pointeur sur la ligne voulue et cliquez sur l’icône dont l’infobulle indique « Détails du paiement ».

L’onglet comporte une recherche, par adresse e-mail du client (correspondance sur une partie de l’adresse) ou par ID de paiement exact, ainsi que des filtres par état du paiement, devise et réseau. L’état affiché à côté du paiement indique son étape : « Créé » et « Non payé » — l’argent n’est pas encore arrivé ; « Partiellement payé » et « Surpayé » — le montant diffère de celui attendu ; « Payé » — le paiement est clos ; « Expiré » — le délai est écoulé ; « Invalidé » — le paiement a été clos sans règlement.

Détails du paiement sur la blockchain

La fiche affiche les transactions trouvées pour le paiement, et le lien « Voir dans l’explorateur » de chacune ouvre l’explorateur de blockchain.

⚠️ Revérification et recherche par hash : Tron et Ethereum uniquement

Les boutons « Revérifier le paiement » et « Vérifier la transaction par ID » n’apparaissent dans la fiche que pour les paiements sur les réseaux Tron et Ethereum, c’est-à-dire TRX, USDT TRC-20 et les autres jetons Tron, ainsi qu’ETH, USDT ERC-20, USDC et les autres jetons Ethereum. Pour Bitcoin, Litecoin et Monero, la fiche n’a pas ces boutons : aucun outil manuel n’est prévu pour ce cas.

Remise du webhook

Dès qu’un paiement est réglé, la fiche affiche un bloc « Remise du webhook » : il indique si la notification d’état de ce paiement précis est bien parvenue à votre boutique. États possibles :

• Remise — la boutique a reçu la notification.
• Envoi en cours… — un envoi est en cours à cet instant.
• Nouvel envoi en attente — la tentative précédente a échoué ; le nouvel essai est en file d’attente et s’exécute automatiquement.
• Non remise — la remise a échoué, et il n’y aura plus de tentatives automatiques.
• Jamais envoyée — l’envoi de la notification n’a encore jamais été tenté.

Scénario 1. Le paiement est réglé, mais le panneau ne l’enregistre pas

Le client affirme avoir envoyé l’argent, mais le paiement n’est toujours pas réglé. Pour Tron et Ethereum, il existe des outils, par ordre croissant d’effort.

Commencez par « Revérifier le paiement ». Le panneau reparcourt les blocs sur toute la durée de vie du paiement, à la recherche de transferts vers son adresse, en contournant le scanner habituel. Le résultat arrive sous forme de notification : si un transfert est trouvé, le panneau le crédite et met à jour l’état du paiement ; s’il n’y en a pas, cela signifie « déjà comptabilisé » pour un paiement déjà réglé, et il reste la vérification par hash de transaction pour les autres. Pas plus de trois revérifications par paiement et par heure.

Si la revérification n’a rien donné, ou si le client peut vous communiquer le hash du transfert, cliquez sur « Vérifier la transaction par ID », collez le hash dans le champ « ID de transaction » et cliquez sur « Vérifier » : c’est une vérification ponctuelle, qui ne modifie rien dans le paiement. Si le transfert se rapporte bien à ce paiement, le bouton « Importer » apparaît. Les autres réponses sont détaillées dans le scénario « L’argent est arrivé au mauvais endroit » ci-dessous. Pas plus de dix vérifications par heure et par terminal.

Scénario 2. Le panneau enregistre le paiement, mais la boutique n’a pas reçu la notification

Le paiement est réglé, mais la boutique n’a pas réagi : la commande ne s’est pas clôturée. La cause se lit dans le bloc « Remise du webhook », qui n’apparaît que pour les paiements déjà réglés.

Le panneau envoie automatiquement les notifications d’état dès que le paiement est clos et, si la première tentative échoue, renouvelle l’envoi toutes les heures jusqu’à recevoir de la boutique la réponse 200 OK. Le bouton « Renvoyer » sert quand il n’est pas souhaitable d’attendre, ou quand les tentatives automatiques sont épuisées :

• à l’état « Nouvel envoi en attente », le panneau envoie la notification tout de suite, sans attendre la prochaine tentative automatique ;
• à l’état « Non remise », il n’y a plus de tentatives automatiques, et c’est le seul moyen de renvoyer la notification ;
• à l’état « Jamais envoyée », la notification est envoyée pour la première fois.

Si le webhook n’est pas renseigné dans les paramètres du terminal, le bouton n’existe pas : la fiche affiche à la place une invitation à renseigner le webhook (cela se fait à l’étape de configuration du webhook lors de l’intégration de la boutique).

⚠️ Renvoyer une notification déjà remise est risqué

Pour l’état « Remise », le panneau avertit expressément : la boutique a déjà reçu la notification, et un nouvel envoi peut entraîner un double crédit du paiement de son côté. Ne renvoyez la notification que si vous êtes certain que la boutique ne l’a pas traitée.

⚠️ « Jamais envoyée » recouvre deux cas distincts

Si la notification avait déjà été générée mais n’est pas partie, le panneau envoie exactement celle-là, sans modification. Mais si la notification n’avait pas encore été générée, le panneau la reconstruit à partir des données actuelles du paiement : elle peut alors différer de ce que la boutique aurait reçu à l’origine.

Le bouton « Renvoyer » est lui aussi limité : pas plus de cinq envois par paiement et par heure.

Scénario 3. L’argent est arrivé au mauvais endroit

Le client vous a envoyé le hash d’un transfert, mais le paiement que vous avez ouvert n’est pas celui qui est concerné : le transfert est arrivé à l’adresse du client, mais s’est rattaché à un autre paiement, ou à aucun. Le panneau attribue en général au client la même adresse pour tous ses paiements et cherche le transfert par adresse, et non par facture précise : n’importe quel paiement de ce client convient donc, pas forcément « le bon ».

Ouvrez la fiche d’un tel paiement, cliquez sur « Vérifier la transaction par ID », collez le hash dans le champ « ID de transaction » et cliquez sur « Vérifier ». Plusieurs cas sont ensuite possibles :

• Le transfert se rapporte à un autre paiement : la fiche de ce paiement s’ouvre, avec le bouton « Importer dans ce paiement », qui crédite le transfert là-bas et non dans le paiement que vous aviez ouvert.
• Aucun paiement ne correspond : le transfert est arrivé à cette adresse alors qu’aucune facture n’était active. Le bouton « Enregistrer comme recharge » crée pour ce transfert un paiement distinct, déjà réglé, afin que l’argent ne soit pas perdu, et envoie à la boutique une notification à son sujet.
• Le transfert a déjà été importé : la fiche indique à quel paiement il se rapporte, aucune action n’est nécessaire.

Les autres réponses — erreur du nœud de la blockchain, restriction de licence et autres — sont expliquées directement dans la boîte de dialogue ; il ne reste alors qu’à réessayer plus tard.

Liens utiles

• Intégrer la boutique à QryptoPay — comment la boutique reçoit et vérifie les notifications par webhook.
• Routage des paiements entre les portefeuilles dans QryptoPay — si les paiements d’un même client se mélangent sans cesse entre les portefeuilles, vérifiez les règles de routage.
• Journal des opérations dans QryptoPay — si le hash trouvé correspond non pas à un paiement client mais à un transfert entre vos propres portefeuilles, l’import par hash se trouve là-bas, dans l’onglet « Opérations ».