What a self-hosted crypto gateway is, what it takes to run one, what it costs, and when a hosted or white-label gateway is the smarter choice for your business.
A self-hosted crypto gateway is payment software that you run on your own server, wired to your own wallets and blockchain nodes, so no third party sits between a customer’s payment and your funds. It gives you maximum control. It also makes you responsible for uptime, security, updates, accounting and compliance. This guide explains how it works, what it takes to run one, what it really costs, and when a hosted or white-label setup gets you the same result with less work.
Every crypto gateway does the same four jobs: it creates an invoice with a payment address and amount, watches the blockchain for incoming transfers, decides when a payment counts as confirmed, and tells your store or app so it can release the order. The difference is who runs those jobs.
In a self-hosted setup, you install the software on a server you control, usually with Docker or a similar tool. You connect it to wallets you control and, ideally, to a blockchain node you run yourself. The code, the database of invoices and the checkout page all live on your machines.
In a hosted setup, the provider runs the software. You create an account, copy an API key into your plugin or code, and the provider handles the monitoring, the checkout page and the settlement.
A third model sits between them: a white-label gateway, where you run the branded product on your own domain but rely on the vendor’s maintained engine. We come back to that below, because it is what many teams actually want when they search for “self-hosted.”
Self-hosting is usually discussed together with non-custodial payments, meaning funds land directly in a wallet you control rather than in an account the provider holds. The two ideas are related but not identical. You can self-host and still route funds through an exchange, and a hosted gateway can in some cases forward funds to your wallet. Ask two separate questions: where does the software run, and who can move the money before it reaches me?
The flow is the same whether you host the gateway or not. Understanding it tells you where things can break.
The edge cases are what separate a toy setup from a production one: underpayments, overpayments, late payments after an invoice expires, payments sent on the wrong network, and webhooks that fail and must be retried.
At minimum you need a server with enough disk, memory and bandwidth for the software and its database, a domain with TLS, a reverse proxy, and regular backups. Add blockchain nodes if you want to verify payments without trusting someone else’s API. A full Bitcoin or Ethereum node needs substantial and growing storage, and it needs time to sync before it is useful. Supporting many coins means many nodes or many third-party node providers, which weakens the independence you were after in the first place.
Cloud deployments add a layer of work: network boundaries, persistent volumes for chain data, and secrets management that keeps application credentials apart from wallet keys.
Someone on your team must be comfortable with Linux administration, containers, TLS, database backups, webhook signing and incident response. They also need to follow security advisories for the gateway software and each coin’s client, then apply updates without downtime during a sale.
A gateway is only useful once it talks to your platform. Check whether a maintained plugin exists for your store software, whether the API covers recurring billing and refunds, and whether you can export clean records for your bookkeeper. Missing features usually mean custom code, and custom code means more to maintain.
The software license for open-source gateways is often zero. The bill arrives elsewhere.
| Cost area | Self-hosted | Hosted gateway |
|---|---|---|
| Software | Often free, or a one-time script license | Included in the service |
| Servers and nodes | You pay monthly, scaling with the number of coins | Provider’s cost |
| Engineering and maintenance | Your staff or contractors | Provider’s team |
| Security and audits | Your responsibility | Shared, with the provider covering its platform |
| Transaction fees | None to a processor, but network fees still apply | A percentage or flat fee per payment |
| Downtime risk | Yours to monitor and fix | Covered by the provider’s infrastructure |
A useful way to decide is to price your engineer’s time. If keeping the gateway healthy takes even a few hours a month, compare that to a percentage on your volume. For a store processing a modest amount in crypto, a processing fee is almost always cheaper than a server, a node and an on-call engineer. For very high volume, the math can flip, which is why volume tiers matter.
Our crypto processing has no setup or monthly fees. You pay a per-transaction fee that falls as your monthly volume grows: Standard is 2%, Growth is 1.5%, Scale is 1%, and Enterprise is 0.1%. If you prefer a predictable amount per payment, the flat per-payment option is $0.10 per payment. That is the number to put against your own server and staffing costs.
Key management. If your server is compromised and wallet keys live on it, funds are gone. Keep hot wallets small, sweep to cold storage, and never store the keys on the same machine that serves your checkout page.
Availability. If your node or gateway is down, customers cannot pay and you may miss payments that arrive during the outage. A hosted provider spreads this risk across redundant infrastructure. On your own, you need monitoring, alerts and a tested recovery plan.
Webhook integrity. Always verify signatures and make order fulfillment idempotent, so a replayed callback cannot release goods twice.
Refunds. Crypto payments are irreversible. A refund is a new outgoing transaction that you send, and the customer must supply a valid address on the right network. Write that process into your policy before the first dispute.
Volatility. Between the moment a customer pays and the moment you pay your suppliers, prices can move. Many merchants convert to a stablecoin at settlement. Our gateway supports auto-conversion to stablecoins for this reason, and you can check prices with the live crypto rates and crypto converter.
Wrong-network and underpayment errors. These are the most common support tickets. Good gateways display the network clearly, handle partial payments by rule, and let support staff resolve edge cases without touching the database.
Self-hosting does not exempt you from the rules. It can add to them.
Tax in the United States. The IRS says that when you provide a service and receive payment in digital assets, the ordinary income you recognize is the fair market value of the assets in U.S. dollars when received. So your records must capture the dollar value at the time of each payment, not at month end. Any later gain or loss when you sell or convert is tracked separately.
Money transmission. FinCEN’s 2019 guidance on convertible virtual currency says a software seller or developer may be exempt from obligations for creating or selling the software, but can still have obligations as a money transmitter if it uses the software to accept and transmit value as a business. If your self-hosted gateway touches funds that belong to other people, for example in a marketplace paying out sellers, get advice from a lawyer who handles money transmission before you launch, not after.
Other countries. Rules differ. In Ireland, for instance, Revenue’s manual states that VAT is due in the normal way on goods or services sold for bitcoin and similar currencies, based on the euro value at the time of supply. Revenue also notes that no special tax rules are needed because existing legislation applies, so businesses record transactions and recognize revenue in the usual way.
In every country the practical task is the same: log the date, the coin, the amount, the fiat value at receipt and the order it belongs to. If you are a Canadian business, a specialist in e-commerce accounting in Ontario can help set up GST/HST and bookkeeping for crypto revenue. Elsewhere, ask an accountant who has handled digital-asset receipts.
Self-hosting makes sense when most of these are true:
A hosted gateway makes sense when:
E-commerce stores. The priority is a working plugin, fast confirmation and clean order status. Our crypto payments for e-commerce setup covers hosted checkout and store plugins without running a server.
Freelancers and agencies. Payment links and invoices in crypto are the whole need. Running a server for that is almost never worth it.
SaaS. Recurring billing is the hard part, because crypto cannot be pulled from a customer’s wallet the way a card can. You need reminders, invoices and grace-period logic, which are costly to build yourself.
Gaming. Automated in-game purchases need fast, reliable webhooks and a clear way to handle underpayments, since players expect items instantly.
Marketplaces. Splitting a payment between the platform and many sellers, then paying them out, brings in both engineering and compliance questions. See crypto payments for marketplaces and our mass payouts.
Many teams that search for a self-hosted gateway want three things: their own branding, their own domain, and no dependence on a third party’s checkout page. They do not necessarily want to maintain blockchain infrastructure. A white-label gateway delivers that. You present payments under your brand, while the vendor maintains the engine, the coin support and the security patches.
We offer this in two forms: a white-label platform, with fees from 1%, and a self-hosted white-label gateway script for teams that want to run the code on their own server. If you plan to resell payments to your own merchants, the platform is built for that.
We process crypto payments for stores, SaaS products, gaming servers and marketplaces, and the pattern is consistent. Teams usually start with self-hosting because they want control and the software is free. Then the first node falls out of sync during a promotion, or a coin upgrade breaks detection, and they discover that the cost of control is attention.
Our view is that control should be spent where it matters. Own your brand, your customer relationship and your treasury decisions. Don’t spend your best engineers on chain monitoring. That is why we built the gateway with no setup or monthly fees, no-KYC onboarding with instant approval, support for more than 110 coins, auto-conversion to stablecoins, and the same product available as hosted checkout, API or white label. We operate as a regulated MSB, so the compliance weight of processing sits with us rather than on your server.
If you still want to run your own, do it with open eyes: small hot wallets, verified webhooks, tested refunds and a bookkeeper who has seen crypto receipts.
— Dustin
If you want crypto payments without maintaining nodes, start with our crypto payment gateway. You get hosted checkout, e-commerce plugins, payment links, API, recurring billing, payouts and auto-conversion, with onboarding that doesn’t require KYC.
Prefer to host it yourself? The white-label gateway script puts the code on your server, while we keep the engine current.
Only sometimes. The software may be free, but you pay for servers, nodes, monitoring and engineering time. At low or moderate volume, a per-transaction fee is usually cheaper than that overhead. At very high volume, volume-tier pricing or self-hosting can come out ahead, so run the numbers on your own figures.
No. Running your own software changes who operates the system, not your tax duties. You still owe tax on crypto revenue, and if you handle other people’s funds you may face money transmission rules. Talk to an accountant for tax and a lawyer for transmission questions.
Yes, but each coin or network usually needs its own node or provider and its own testing. A hosted gateway such as ours supports over 110 cryptocurrencies without you running that infrastructure.
Crypto transfers can’t be reversed, so a refund is a new payment you send to an address the customer gives you. Confirm the coin and network with them first, and decide in advance whether you refund the original crypto amount or its dollar value at the time of purchase.
Open a free CryptoPayr account and take your first crypto payment the same day.
Get started for free
What zero confirmation crypto payments are, why they stall, the double-spend risk, and a practical way for merchants to decide when to accept one and when to wait.
A crypto payment arrived short of the invoice. Learn why underpayments happen, how to verify them on-chain, and how merchants can fix and prevent them.
Send crypto payment alerts to a Discord channel with webhooks: which events to post, what each message should hold, and how to keep it reliable and private.