How to Use the Wallet Block in UniLink (Accept Crypto Payments on Your Page)
How to Use the Wallet Block in UniLink (Accept Crypto Payments on Your Page)
A step-by-step guide to adding the Wallet block to your UniLink page so visitors can send you crypto payments or tips without leaving your link-in-bio.
- The Wallet block adds a crypto payment address or button to your page — supporting BTC, ETH, SOL, USDC, USDT, and other major coins — so crypto-native audiences can pay, tip, or donate without fiat banking.
- Two display modes: QR code + address display (visitor scans or copies the address), or a "Pay with crypto" button that links to an external processor like Coinbase Commerce or NOWPayments.
- UniLink does not process crypto payments internally — it is a display and link layer only. Actual transactions happen on the processor or directly on-chain.
- The most common mistakes are showing too many coins at once (confusing), pasting the wrong wallet address (permanently losing payments), and using QR-only mode on desktop where nobody can scan their own screen.
Crypto creators, NFT artists, and Web3 community builders have a recurring problem: their audiences want to pay in crypto, but their link-in-bio tools force them into fiat-only checkout pages, PayPal flows, or Stripe — none of which accept Bitcoin or Ethereum. The result is friction, abandoned transactions, and revenue that never arrives. The Wallet block solves this by putting your crypto address or payment button front and center on your page, in the exact format your audience already knows how to use. No workarounds, no screenshots of QR codes pasted into stories, no pinned tweets with wallet addresses that scroll out of reach.
What the Wallet block does
The Wallet block creates a dedicated payment module on your UniLink page for receiving cryptocurrency. In QR and address display mode, it shows a scannable QR code alongside your wallet address as copyable text — the visitor either scans the QR with their mobile wallet app or copies the address and pastes it into their crypto exchange or wallet. In button mode, it shows a "Pay with crypto" (or custom-labeled) button that links out to an external payment processor like Coinbase Commerce or NOWPayments, where the visitor completes the transaction on the processor's hosted page. Both modes support adding a label, an optional description, and a selection of supported coins.
The block supports the major cryptocurrencies: Bitcoin (BTC), Ethereum (ETH), Solana (SOL), USDC, USDT, and other widely-used coins. You can configure the block for a single coin or multiple coins. Multi-coin mode displays either a selector dropdown or separate address rows for each currency, depending on the display style. For button mode linked to a processor, the processor itself handles which currencies it accepts — you just provide the payment link. The block requires no wallet connection on UniLink's side; it stores and displays whatever addresses you provide.
There are important limits to understand. UniLink does not process, relay, or confirm crypto transactions — it has no connection to any blockchain. If a visitor sends funds to a wrong address, UniLink has no record of or recourse for that transaction. The block does not show a running total of donations received, a transaction history, or a "goal reached" indicator. It is purely a display and routing layer. For more sophisticated crypto commerce — invoice generation, automatic fiat conversion, transaction confirmations — you need to connect an external processor via the button mode and configure that functionality there.
Before you start
- Have your wallet address ready: Copy your receiving wallet address for each coin you want to accept. Double-check each address against the address shown in your wallet app or exchange — a single wrong character means any payment sent to it is permanently unrecoverable. Never type addresses manually; always copy-paste and verify.
- Decide on display mode: Choose before you open the editor. QR + address mode is best for mobile-first audiences where visitors will scan on their phone. Button mode is best when you want to send visitors to a processor that handles invoices, confirmations, and fiat conversion. If your audience is primarily on desktop, avoid QR-only mode — desktop users cannot scan their own screen.
- Set up your processor account (button mode only): If using button mode, create and configure your account on Coinbase Commerce, NOWPayments, or your preferred processor. Get your payment link or widget URL from there — you will paste this into the block's button URL field.
- Choose which coins to accept: Pick one to three coins that match your audience. Showing all available coins at once rarely helps — if your community is Solana-native, showing six coin options including obscure tokens creates confusion rather than convenience. Start with the one or two coins your audience actually uses.
How to add the Wallet block to your page
- Open your page in the Dashboard: Log in to UniLink, go to My Pages, and click Edit on the page where you want the Wallet block to appear.
- Add a new block: Click + Add Block in the editor. In the block picker, scroll to the Commerce or Payments section and select Wallet.
- Select your display mode: In the block settings panel, choose between QR + Address and Button. This determines the entire layout and what fields appear next. You can switch modes later, but the address and button URL fields are separate — switching modes does not carry over your data.
- Add your cryptocurrency and address (QR + Address mode): Select the coin from the dropdown (BTC, ETH, SOL, USDC, USDT, or another supported option) and paste your wallet address into the address field. The QR code generates automatically from the address you enter. Add a second coin row if needed — but keep it to two or three maximum.
- Configure the button and URL (Button mode): Enter your button label (e.g., "Pay with Crypto", "Support in ETH", "Buy with Bitcoin") and paste the payment processor URL into the button link field. This should be a direct link to your Coinbase Commerce checkout, NOWPayments invoice, or equivalent processor page.
- Write a label and optional description: Add a short label above the block explaining what the payment is for — "Support my work", "Pay for a commission", "Tip in BTC". Without a label, visitors who are unfamiliar with your page context do not know what they are paying for. The optional description field is useful for adding payment instructions, a minimum tip amount, or a note about what the funds support.
- Save and publish: Click Save, then Publish to make the block live. After publishing, visit your page on both a mobile device and a desktop. On mobile, confirm the QR code is scannable with your wallet app. On desktop, confirm the address is copyable and the button link opens correctly. Test that each displayed address exactly matches your intended receiving wallet — this is the most important verification step.
Key settings explained
| Setting | What it controls | Best practice |
|---|---|---|
| Display mode | Whether the block shows a QR code + address or a payment button linking to a processor | Use QR + address for a mobile-first audience who will scan on their phone; use button mode when you need processor features like invoices, email confirmations, and fiat conversion |
| Cryptocurrency selector | Which coin(s) the block displays — each coin gets its own address row and QR code | Limit to 1–3 coins that your specific audience uses; showing every supported coin creates decision paralysis and makes your page look like a crypto exchange listing |
| Wallet address | The receiving address for each selected coin — generates the QR code and copyable text | Always paste from your wallet app; verify the first and last 6 characters against your source — if even one character is wrong, every payment to that address is unrecoverable |
| Block label | The headline displayed above the QR code or button explaining what the payment is for | Be specific about intent — "Support my art in ETH" or "Pay for a 1:1 session in USDC" converts better than a generic "Donate" label with no context |
| Optional description | Secondary text below the label — instructions, minimum amounts, use-of-funds notes | Use for any context that reduces friction: "Minimum tip: 0.001 ETH", "Payments confirm within ~2 minutes", "All proceeds fund the project directly" |
| Button link URL (button mode) | The destination URL when a visitor clicks the payment button | Use a direct payment page URL from your processor, not a homepage — a visitor clicking "Pay with Crypto" expects to land on a checkout page, not your Coinbase Commerce dashboard home |
| Button label (button mode) | The text displayed on the call-to-action button | Match the label to the action: "Pay in ETH", "Buy with USDC", "Support in BTC" — action-specific labels outperform generic "Pay Now" because they confirm which currency the visitor will use |
Getting conversions from your Wallet block
The most common reason Wallet blocks get ignored is that visitors do not know what the payment is for. A QR code with no label reads as technical noise, not a call to action. Use the label and description to answer the three questions every crypto visitor needs before opening their wallet: what am I paying for, how much is expected, and who receives it. A block that answers all three in two sentences converts willing payers. A block with no label converts almost nobody.
For tip or support use cases, place the Wallet block below your main content — after featured links, products, or social proof. Visitors who have engaged with your content first are far more likely to send a tip than visitors who see a QR code the moment they land. If crypto commerce is your primary business model, put the block higher, but always pair it with a clear description. Desktop visitors cannot scan a QR code from their own screen — if your analytics show a significant desktop audience, enable the copyable address text alongside the QR, or switch to button mode entirely.
For button mode, test end-to-end before publishing: open your page on a phone, click the button, and confirm the processor shows the currencies you advertised. A visitor who clicks "Pay in ETH" and lands on a Bitcoin-only processor will bounce — and the mismatch creates enough distrust that they may not return.
Troubleshooting common issues
| Problem | Likely cause | Fix |
|---|---|---|
| QR code does not scan | The QR code is displayed too small on the visitor's screen, or the wallet address contains an invalid character | Ask visitors to zoom in or screenshot and scan — or switch to address + copy mode alongside the QR; also re-verify the pasted wallet address for any extra spaces or malformed characters |
| Payment sent but never received | Wallet address was entered incorrectly — one wrong character routes to an unrelated or nonexistent address | UniLink cannot recover misdirected crypto transactions; verify the address in the block settings against your wallet app right now — edit and republish with the correct address for all future payments; past misdirected funds are irrecoverable |
| Button link opens the wrong page | The button URL points to the processor homepage rather than a specific payment page | Log in to your processor (Coinbase Commerce, NOWPayments, etc.) and copy the direct checkout link for your specific product or payment page, not the platform's root URL |
| Block shows no QR code after saving | The wallet address field was left blank or the address failed validation | Re-open the block editor, confirm the address is pasted correctly with no leading or trailing spaces, save again, and refresh the live page |
| Desktop visitors say the QR code is useless | QR-only mode on desktop — visitors cannot scan their own screen | Enable the "show address text" option to display the copyable wallet address alongside the QR code; desktop users will copy and paste rather than scan |
| Visitors confused about which coin to use | Too many coin options displayed at once with no guidance | Reduce to one or two coins and add a description explaining which is preferred — "We accept ETH on Ethereum mainnet; for lower fees use SOL" removes confusion immediately |
| Block appears but no visitors interact with it | No label or description explaining what the payment is for | Add a specific label ("Support my NFT project in ETH") and a one-sentence description — anonymous QR codes with no context get ignored even by willing payers |
Best fit for
- NFT artists and Web3 creators who sell commissions, mint passes, or accept tips from a crypto-native audience
- International creators who want to accept payments without fiat banking, PayPal, or Stripe geographic restrictions
- Creators whose audience is primarily on Solana, Ethereum, or Bitcoin ecosystems and prefers on-chain payments
- Web3 community builders accepting DAO contributions, crowdfunding, or project funding in stablecoins like USDC or USDT
- Anyone who already uses Coinbase Commerce or NOWPayments and wants a clean button on their page without building a custom integration
Not the right tool if
- Your audience is mainstream and not crypto-familiar — a QR code and a wallet address will confuse rather than convert non-crypto visitors
- You need payment confirmations, invoices, or automated delivery on purchase — use button mode with a processor that handles these, or use the Digital block for file delivery
- You need to track how much you have received — the Wallet block has no transaction history or running total; check your wallet or processor dashboard for that
- You are selling physical goods or services requiring a billing address and shipping details — the Shop block or an external checkout is the right fit
Frequently asked questions
Does UniLink take a fee on crypto payments?
No. UniLink does not process crypto transactions and does not take a percentage of payments made through the Wallet block. The block is purely a display and link layer — payments go directly from the sender's wallet to yours on-chain, or through your chosen third-party processor (Coinbase Commerce, NOWPayments) which may charge its own processing fee. UniLink has no visibility into the transaction itself.
Can I accept the same coin on multiple blockchain networks (e.g., ETH on Ethereum and ETH on Base)?
The block's coin selector distinguishes coins by name, not by network. If you accept ETH on both Ethereum mainnet and Base, add a description clarifying which network you want senders to use — misdirected cross-chain transactions are not recoverable. If you need strict network separation, use separate Wallet blocks with explicit network labels for each one.
What happens if a visitor sends crypto to the address but I have since changed my wallet?
Any payment sent to the address displayed in your block goes to whatever wallet controls that address on-chain — UniLink cannot intercept, redirect, or hold crypto in transit. If you change wallets, update the address in the block settings and republish immediately. Do not leave an old wallet address on the page if you no longer have access to that wallet, as incoming payments would be inaccessible to you.
Can I show a donation goal or progress bar alongside the Wallet block?
The Wallet block itself does not include a goal tracker or progress bar. If you want to display a fundraising goal, you can use a separate text or banner block above the Wallet block and manually update the goal text as funds come in. Automated on-chain progress tracking is not available within UniLink — your processor dashboard or a third-party crypto fundraising tool would need to handle that.
Can I use the Wallet block for stablecoins like USDC or USDT?
Yes. USDC and USDT are supported alongside BTC, ETH, SOL, and other major coins. Stablecoins are often a better choice for commerce use cases — the sender knows exactly what dollar amount they are sending, there is no volatility risk during the transaction window, and many buyers prefer paying in stablecoins when purchasing services or commissions at a fixed price.
- Always copy-paste wallet addresses and verify the first and last 6 characters — a single wrong character makes every payment to that address unrecoverable, and UniLink has no way to help.
- Avoid QR-only mode for desktop audiences — enable the copyable address text alongside the QR so desktop users can paste the address into their wallet without needing to scan.
- Limit displayed coins to 1–3 that match your specific audience; showing every available option creates confusion and lowers conversions compared to a focused single-coin block with clear context.
- Use button mode linked to a processor (Coinbase Commerce, NOWPayments) when you need payment confirmations, invoices, or automatic fiat conversion — the Wallet block itself provides none of these.
- A label and description are not optional — an unlabeled QR code with no context converts almost nobody; tell visitors exactly what they are paying for and why in two sentences or fewer.
Ready to start accepting crypto on your page? Create your free UniLink page and add a Wallet block to reach your crypto-native audience without fiat payment friction.
Create Your Free Link-in-Bio Page
Join thousands of creators using UniLink. 40+ blocks, analytics, e-commerce, and AI tools — all free.
Get Started Free