Setting up the QryptoPay payment page
This article continues the guide on adding your first wallet for accepting payments. The wallet is added, so there's somewhere for the money to go — now your customers need a page where they can make payments.
💡 This step may already be done
If you specified a domain when creating the merchant during the quick start, the payment page was created along with it. Open the merchant, check that the page loads on your domain, and move on to the next step. What follows is for those who didn't have a domain yet, or whose page creation didn't succeed.
What you need
- The Nginx module — the payment page runs as an Nginx virtual host, and you can't stand it up without Nginx. If the module isn't installed yet, open the Nginx section in the sidebar, click "Install", and wait for it to finish.
- A domain name — pointed with an A record to the server running the panel, for example
qpay.your-site.com. Customers will see this address while paying, so pick a domain your customers trust: a subdomain of your main site works better than an unfamiliar name.
Creating the page
Page creation starts from the sidebar:
- In the QryptoPay sidebar, find your merchant in the list.
- Hover over it — a globe icon with the "Create payment page" tooltip appears next to the name. If Nginx isn't installed, the icon is disabled and shows "Install Nginx first" — you can install it from the Nginx section in the sidebar.
- Click the icon — the "Create payment page" dialog opens.
In the dialog, fill in:
- "Domain name" — the domain you pointed to this server;
- in the additional settings, keep "HTTPS (port 443)" — an SSL certificate will be issued for the payment page.
Click "Create".
Once created, the panel reports the result: the page was created, the page was created without a certificate (the domain failed validation — check the A record and try again), or the page couldn't be created.
⚠️ Don't edit this host in the Nginx module
The created page shows up in the Nginx virtual host list, but it should only be managed from the merchant. The panel builds this host from its own template, proxying /public/api/ and /public/ws/ requests to the QryptoPay socket. Manual edits are overwritten the next time the page is changed from the merchant, and touching those locations breaks the payment page and stops payments.
Logo on the payment page
By default, customers see the standard QryptoPay branding on the payment page. The merchant's "Payment page" tab lets you put up your own logo — the one your customers already know from your site.
The logo is set separately for the light and dark theme: you upload the "Light theme logo" first, after which the "Dark theme logo" becomes available. If you don't need a dark variant, you can reset it to the light one at any time with the "Reset to light logo" button.
- Supported formats: PNG, JPEG, GIF, SVG.
- Combined file size — up to 4.5 MB.
‼️ Resetting branding can't be undone
The "Reset all branding" button removes both logos, and the payment page reverts to the standard QryptoPay look. This can't be undone — you'll have to upload the logos again from scratch.
Next step
Now your customers can reach the payment page and complete a payment. What's left is connecting your store to the terminal so payments are fully automated:
- Store integration with QryptoPay — payment links, webhook, and an end-to-end test payment.