DEV Community

Olivia
Olivia

Posted on

Payment gateway for cryptocurrency: setup checklist for merchants

A payment gateway for cryptocurrency takes an afternoon to install and a few weeks to trust. The install is the easy part. The weeks go to boring details, like what happens when a customer sends 47 dollars against a 50 dollar invoice at 2 a.m. This is the Payment gateway for cryptocurrency: setup checklist for merchants that I'd want beside me before touching an API key. It's written for developers and store owners working on the same launch.

The short answer

Payment gateway for cryptocurrency: setup checklist for merchants comes down to eight jobs. Choose a custody model, choose coins and networks, lock down the account, connect checkout, handle webhooks properly, define payment states, test the ugly cases, and go live small. Skip one and you'll find out with a real customer's money.

Step 1. Pick a custody model

A custodial gateway receives the funds first, then pays you out, often after converting to fiat. It's simpler, and you trust the provider until payout. A non-custodial gateway sends payments straight to a wallet you control. You keep the keys, and the risk of losing them.

Ask three questions before you sign up. Who holds the funds and for how long? Can I be paid in fiat, stablecoins, or both? What happens to my balance if the account is frozen? Vague answers on the last one are a warning.

Step 2. Choose coins and networks

Start with a stablecoin like USDT or USDC, because a 50 dollar order stays a 50 dollar order. Add Bitcoin and Ethereum if your buyers ask.

The network matters more than the coin. USDT runs on several chains, and sending it can cost a few cents or several dollars depending on which one. Check how the gateway handles coins that need a memo or tag, like XRP. Switch off anything you don't want, since every extra coin is another wrong-network support ticket.

Step 3. Lock down the account

Finish business verification early, because approval can take days. Then set the basics.

Turn on two-factor login
Whitelist payout addresses, so a stolen password can't send funds to a stranger
Keep API keys in environment variables, never in front-end code or a public repo
Use separate keys for test and live, and rotate any key that leaks
Step 4. Connect checkout

You have three routes. A plugin is the fastest for platforms like WooCommerce. A hosted checkout redirects the buyer to the gateway's payment page and needs little code. A direct API gives you full control and more upkeep. Shopify limits some third-party payment methods, so read its current rules first.

Create invoices on your server, never from the browser, or a buyer can edit the amount. The gateway returns an address, a crypto amount, and a locked exchange rate, often valid for 10 to 20 minutes. Show the amount, address, QR code, network, and a countdown. Whichever route you pick, tick it off against this Payment gateway for cryptocurrency: setup checklist for merchants before you ship.

Step 5. Get webhooks right

Webhooks are the messages that tell your store a payment was detected, confirmed, or expired. Skip this step and the rest of the Payment gateway for cryptocurrency: setup checklist for merchants won't save you. Three rules.

Verify the signature. Otherwise anyone who finds your URL can mark an order as paid.
Make the handler idempotent. Gateways retry, so the same event can arrive twice.
Answer fast and do slow work, like emails, in a queue.

Log every webhook for the first few weeks. A plain text log solves more bugs than any dashboard.

Step 6. Define payment states

Real customers do messy things, so write the rule for each case before launch.

Underpaid. A wallet took its fee out of the amount. Ask for the gap, accept a small margin, or refund.
Overpaid. Refund the extra or issue store credit.
Expired. The customer paid after the rate window closed. Requote or review manually.
Wrong network. Recovery depends on the provider.
Slow confirmation. Keep the order pending. Don't cancel it.

Also set your confirmation threshold. A 15 dollar download can release after one confirmation. A 5,000 dollar order should wait for more. Bitcoin blocks average about ten minutes, so six confirmations take roughly an hour, while Tron and Solana confirm in seconds.

Step 7. Test the ugly cases

Use the gateway's sandbox, or a testnet like Ethereum's Sepolia, where coins have no value. A Payment gateway for cryptocurrency: setup checklist for merchants isn't finished until each case below has a written expected outcome.

Correct payment
Slightly under
Slightly over
After the invoice expires
Duplicate webhook
Invalid signature
Cancelled order

One clean payment proves only the happy path. It says nothing about a customer underpaying at 2 a.m.

Step 8. Go live small, then watch

Send a real payment of a few dollars. Buy your own product, watch the order flip to paid, and check the payout. Then send a refund, because refunds are manual and go back on-chain, usually minus the network fee.

Three side jobs belong here. Accounting first. Crypto revenue counts as income in most countries, and you'll usually record its value at the moment of receipt, so ask an accountant and pick a gateway with clean exports. Fees next. Many gateways charge roughly 0.5% to 1% per transaction, plus network, conversion, and payout fees, while US card processors commonly charge around 2.9% plus a fixed fee, so add everything up per order. Support last. Send a specific pre-sales question and time the reply. Real support never asks for your seed phrase or private key.

Common mistakes

Most launches that go wrong skip the same items on the Payment gateway for cryptocurrency: setup checklist for merchants. They skip signature checks. They leave keys in a theme file. They ship a handler that fulfills twice. They set the invoice window too short, forget to name the network at checkout, and test once.

Where FaradPay fits

FaradPay is a crypto payment provider, so it goes through the same eight steps. Check its custody model, supported coins and networks, integration options, webhook documentation, payout terms, and support response time against your notes. Then compare it with two other providers. Your own checklist is the fairest way to judge Payment gateway for cryptocurrency: setup checklist for merchants for any name on your list.

FAQ on Payment gateway for cryptocurrency: setup checklist for merchants

How long does setup take?
A plugin install can take a few hours plus verification time. A custom API build usually takes several days including testing.

Do I need a developer?
Not for a plugin or hosted checkout. For a custom API build, you need someone comfortable with webhooks.

Do I have to hold crypto?
No. Many gateways convert payments to fiat or stablecoins automatically.

What are webhooks and why do they matter?
They're automatic messages from the gateway to your server. Without them, orders don't update after payment.

How do refunds work?
You send them manually, back on-chain, and the network fee usually comes out of the amount.

Can customers get chargebacks?
No. Confirmed blockchain payments are final.

Is it legal to accept crypto?
In most countries, yes, but licensing, reporting, and tax rules differ. Check local law and ask an accountant.

Final thoughts

The install is easy. The checklist is what protects you. Choose custody deliberately, keep the coin list short, verify every webhook, write down each payment state, and launch with a few dollars before real orders. That's the working core of Payment gateway for cryptocurrency: setup checklist for merchants, and it fits in an afternoon.

Top comments (0)