faq

Dépannage

Mis à jour: 09/03/2026

Paiement non reçu

Le client affirme avoir payé, mais la transaction est affichée comme « En attente » ou aucune transaction n’apparaît.

Vérifier la blockchain: Utilisez un explorateur de blockchain (par exemple, Etherscan, Blockchain.com) pour vérifier le hachage de la transaction. Confirmez que le paiement a été envoyé à la bonne adresse.

Vérifier les confirmations: Le paiement peut être en attente du nombre requis de confirmations. Accédez à votre tableau de bord → Transactions et recherchez le statut de la transaction.

Vérifier le montant: Si le client a envoyé un montant inférieur au montant requis, la transaction sera marquée comme sous-payée, sauf si l’option « Accepter les sous-paiements » est activée.

Vérifier l’adresse: Assurez-vous que le client a envoyé à la bonne adresse de portefeuille et sur le bon réseau. Une erreur courante consiste à envoyer des jetons ERC-20 à une adresse TRC-20 (réseaux différents, les fonds peuvent être perdus).

Vérifier la cryptomonnaie: Vérifiez que le client a payé avec la cryptomonnaie qu’il a sélectionnée, et non avec un jeton différent sur le même réseau.

Si la transaction est confirmée sur la blockchain mais n’est pas reflétée dans QuantaPay, utilisez l’API check-transactionpour forcer une nouvelle vérification.
Si le paiement a été envoyé à la mauvaise adresse ou au mauvais réseau, QuantaPay ne peut pas récupérer les fonds.

Les paiements sont effectués dans le tableau de bord QuantaPay, mais votre serveur ne reçoit pas les notifications de webhook.

Vérifier l’URL du webhook: Accédez à Paramètres → Paiements → Webhook et confirmez que l’URL est correcte.

Vérifier l’accessibilité du point de terminaison: Assurez-vous que votre point de terminaison de webhook est accessible publiquement via HTTPS. Testez avec curl :

   curl -X POST https://yoursite.com/wp-json/quantapay/webhook \
     -H "Content-Type: application/json" \
     -d '{"test": true}'

Vérifier les journaux du serveur: Recherchez les requêtes POST entrantes vers votre point de terminaison de webhook. S’il n’y en a aucune, le problème est lié à la livraison. S’il y a des erreurs 500, le problème se trouve dans votre code de gestion.

Pare-feu / WAF: Si vous utilisez Cloudflare, assurez-vous que le point de terminaison de webhook est autorisé (voirWordPress / WooCommercepour la configuration de Cloudflare).

Vérifier le statut du webhook: Dans votre tableau de bord → Transactions, la colonne « Webhook » affiche1si le webhook a été envoyé pour cette transaction.

Corrigez l’URL du webhook ou l’accessibilité du point de terminaison.
Utilisez temporairement un service de test de webhook (webhook.site) pour confirmer que QuantaPay envoie des webhooks.
En dernier recours, interrogez l’API get-checkout-sessionpour vérifier le statut du paiement.

Les appels d'API renvoient des erreurs, des délais d'attente ou des réponses inattendues.

Erreur	Cause	Correction
`api-key-not-found`	Paramètre`api-key`manquant.	Inclure`api-key`dans chaque requête POST.
`invalid-api-key`	Clé API incorrecte.	Copiez la clé correcte depuis Paramètres → Compte.
`function-not-found`	Faute de frappe dans le nom de la fonction.	Vérifiez l'orthographe du nom de la fonction.
`missing-argument`	Paramètre obligatoire manquant.	Consultez la documentation de l'API pour connaître les paramètres obligatoires.
Délai d'attente de connexion	Problème de réseau ou serveur hors service.	Réessayez après quelques secondes.
Erreur SSL	Problème de certificat.	Assurez-vous que les certificats CA de votre serveur sont à jour.

Tester avec curl: Utilisez curl pour déterminer si le problème se situe dans votre code ou dans l'API :

   curl -X POST https://cloud.quantapay.app/api.php \
     -d "function=get-balances" \
     -d "api-key=YOUR_API_KEY"

Vérifier le format de la réponse: Toutes les réponses suivent le format{"success": true/false, ...}. Analysez le champsuccessavant d'accéder à laresponse.

Enregistrer les requêtes: Enregistrez la requête et la réponse complètes pour le débogage.

Vérifiez que l'URL du webhook est configurée à la fois dans WordPress et dans QuantaPay Cloud.
Consultez le journal de débogage de WordPress (wp-content/debug.log) pour détecter d'éventuelles erreurs.
Assurez-vous que la commande WooCommerce existe et qu'elle est au statut "En attente".

Effacez tous les plugins de mise en cache (WP Super Cache, W3 Total Cache, etc.).
Vérifiez les permissions des fichiers surwp-content/.
Vérifiez que l'utilisateur de la base de données dispose des permissions d'écriture.