Configurer la page de paiement QryptoPay
Cet article prolonge le guide sur l’ajout de votre premier portefeuille pour accepter des paiements. Le portefeuille est ajouté, l’argent a donc un endroit où arriver : il faut maintenant à vos clients une page où ils pourront payer.
💡 Cette étape est peut-être déjà faite
Si vous avez indiqué un domaine en créant le marchand lors du démarrage rapide, la page de paiement a été créée en même temps. Ouvrez le marchand, vérifiez que la page s’ouvre sur votre domaine et passez à l’étape suivante. La suite concerne ceux qui n’avaient pas encore de domaine à ce moment-là, ou dont la création de la page a échoué.
Ce qu’il faut
- Le module Nginx — la page de paiement fonctionne comme un hôte virtuel Nginx, impossible de la mettre en place sans lui. Si le module n’est pas encore installé, ouvrez la section Nginx dans le menu latéral, cliquez sur « Installer » et attendez la fin de l’installation.
- Un nom de domaine — pointé par un enregistrement A vers le serveur où se trouve le panneau, par exemple
qpay.your-site.com. Vos clients verront cette adresse au moment de payer ; choisissez donc un domaine en lequel ils ont confiance : un sous-domaine de votre site principal convient mieux qu’un nom inconnu.
Créer la page
La création de la page se lance depuis le menu latéral :
- Dans le menu latéral de la section QryptoPay, repérez votre marchand dans la liste.
- Placez le pointeur dessus : à droite du nom apparaît une icône de globe avec l’infobulle « Créer une page de paiement ». Si Nginx n’est pas installé, l’icône est inactive et indique « Installez d’abord Nginx » ; vous pouvez l’installer dans la section Nginx du menu latéral.
- Cliquez sur l’icône : la boîte de dialogue « Créer une page de paiement » s’ouvre.
Dans la boîte de dialogue, renseignez :
- « Nom de domaine » — le domaine que vous avez pointé vers ce serveur ;
- dans les paramètres supplémentaires, laissez « HTTPS (port 443) » : un certificat SSL sera émis pour la page de paiement.
Cliquez sur « Créer ».
Une fois la création terminée, le panneau annonce le résultat : page créée, page créée sans certificat (le domaine n’a pas passé la vérification — contrôlez l’enregistrement A et recommencez) ou échec de la création de la page.
⚠️ Ne modifiez pas cet hôte dans le module Nginx
La page créée apparaît dans la liste des hôtes virtuels Nginx, mais elle ne doit se gérer que depuis le marchand. Le panneau construit cet hôte à partir de son propre modèle, en relayant les requêtes /public/api/ et /public/ws/ vers le socket de QryptoPay. Les modifications manuelles sont écrasées à la prochaine modification de la page depuis le marchand, et si vous touchez à ces adresses, la page de paiement cesse de répondre et les paiements s’arrêtent.
Logo sur la page de paiement
Par défaut, les clients voient sur la page de paiement l’image de marque standard de QryptoPay. L’onglet « Page de paiement » du marchand permet de placer votre propre logo, celui que vos clients connaissent grâce à votre site.
Le logo se définit séparément pour le thème clair et pour le thème sombre : on téléverse d’abord le « Logo pour le thème clair », ce qui rend ensuite disponible le « Logo pour le thème sombre ». Si vous n’avez pas besoin d’une variante sombre, vous pouvez à tout moment la ramener à la version claire avec le bouton « Revenir au logo clair ».
- Formats : PNG, JPEG, GIF, SVG.
- Taille totale des fichiers : jusqu’à 4,5 Mo.
‼️ La réinitialisation de l’image de marque est irréversible
Le bouton « Réinitialiser l’image de marque » supprime les logos, et la page de paiement retrouve l’apparence standard de QryptoPay. Cette action ne peut pas être annulée : il faudra téléverser de nouveau les logos.
Étape suivante
Vos clients peuvent maintenant accéder à la page de paiement et effectuer un paiement. Il reste à relier votre boutique au terminal pour que le paiement soit entièrement automatisé :
- Intégrer la boutique à QryptoPay — liens de paiement, webhook et paiement de test de bout en bout.