Launch your own crypto payment gateway
The White-Label Gateway is a complete, self-hosted payment platform you run under your own brand and domain. Your merchants register with you, create payments from a dashboard or the REST API, send customers to a hosted checkout on your domain, and withdraw to any coin — while every transaction settles through your single CryptoPayr account. You set the fees on top of ours and keep the difference. CryptoPayr is never shown to your merchants or their customers.
How to accept crypto payments on White-Label Gateway
Follow these steps to start taking Bitcoin, Ethereum, USDT and 110+ other coins.
-
Upload the script
Unzip the package onto your web server — at the root of a domain such as
pay.yourbrand.comor in a sub-folder. Apache withmod_rewrite(or nginx with the snippet in the README) and PHP 8 with MySQL are all it needs. No Composer, no build step. -
Run the installer
Open
/install.php. It checks the server, connects your MySQL database, asks for your site title, public URL and brand colour, then verifies your CryptoPayr API key and withdrawal key live against our API. Set your fee markup, optional SMTP details and the admin account, and it writesconfig.phpand locks itself. -
Add the cron
Paste the one-line cron shown on the last installer page (every 1–5 minutes). It confirms payouts, expires old payments, retries merchant webhooks and keeps the coin list current. Payments themselves settle from our signed webhook, which the script attaches to every payment automatically.
-
Brand it
In Admin → Settings upload your logo and favicon, pick the colour and default theme, and add your terms, privacy and support links. The checkout, portal, emails and API docs all follow.
-
Onboard merchants
Merchants sign up on your site (or you create them and close registration), get their own
wl_live_API key and withdrawal key, a hosted checkout link per payment, signed webhooks, and a USD balance they withdraw as crypto. You watch it all — and your margin — from the admin overview.
Need the full reference? See the API & webhook documentation, or read about the crypto payment gateway.
Requirements & compatibility
- PHP 8.0+ with PDO MySQL, cURL, OpenSSL, mbstring
- MySQL 5.7+ / MariaDB 10.3+
- Apache
mod_rewriteor nginx, HTTPS reachable from the internet - A CryptoPayr account on USD settlement with its API key & withdrawal key
Frequently asked questions
Does it need sub-accounts or a platform account on CryptoPayr?
No. Everything runs through your one ordinary CryptoPayr account: the script only needs its sk_live_ API key for payments and its wk_live_ withdrawal key for payouts. Merchant balances are kept in the script's own database and every payout is dispatched from your account.
How do I earn on it?
You set a percentage and fixed markup per payment and a percentage on payouts (globally, or per merchant in the admin panel). Merchants are credited net of CryptoPayr's fee plus your markup and see one combined fee. The admin overview shows your CryptoPayr balance minus what you owe merchants — that difference is yours.
Is the checkout really on my domain?
Yes. The coin picker, deposit address, QR code and confirmation are rendered by the script at /checkout/… on your domain. The deposit address is minted through our API behind the scenes; the buyer never leaves your site.
Which coins can merchants accept and withdraw?
Every coin and network CryptoPayr supports at checkout, pulled live from our catalogue. Payouts go out to any supported coin except USDT, which the converting account cannot send.
What if a webhook is missed?
The cron reconciles every open payment and in-flight payout against our API, so a lost webhook still settles. Merchant webhooks are retried with backoff for 24 hours, and both directions are logged in the admin panel.
Can I customise the code?
It is plain PHP with Bootstrap 5 templates under views/ and a small class library under app/. Change anything you like; the README maps every file.