Troubleshooting
Solana Pay not working?
You scanned a Solana Pay QR or tapped a solana: link, but nothing happened —
or you approved the payment and the site never rolled. This guide covers the most common
Solana Pay failures on mobile and desktop, then lets you retry a
0.001 SOL practice roll in the pay panel below.
Quick diagnosis
| What you see | Likely cause | Fix |
|---|---|---|
| QR will not scan | Camera app does not read solana: URLs |
Open Phantom or Solflare and use the in-app scanner |
| Wallet opens with wrong amount | Stale page or edited QR | Refresh the site, regenerate the QR, scan again |
| Approved but site stuck | Detection lag or wrong tab | Tap detect-and-roll, wait, or paste tx signature |
| Payment succeeded on Solscan only | Sent to wrong address or wrong network | Check recipient on tx lookup; confirm mainnet |
| Nothing happens in in-app browser | Twitter/Discord blocks wallet deeplinks | Open the same URL in Safari or Chrome |
| Insufficient funds in wallet app | Payment + fee exceeds balance | Add SOL for payment + fee |
1. QR code will not scan
Solana Pay QRs encode a solana: transfer URL — not a plain text address.
The iPhone or Android camera app often shows "no usable data" because
it does not know how to open wallet deeplinks.
- Install Phantom or Solflare on your phone.
- Open the wallet app, find Scan QR (not the system camera).
- On the site, open the Solana Pay tab and point the wallet scanner at the QR.
- If the code is small, zoom the page or move closer — screen glare matters.
New to Solana Pay? See the Solana Pay QR guide and free QR generator.
2. Wallet shows wrong recipient or amount
Before you tap Approve, check three fields in the wallet preview:
- Recipient — must match the treasury or merchant address on the site
- Amount — Garden Dice defaults to 0.001 SOL unless you changed the slider
- Network — must be Mainnet Beta, not Devnet
If anything looks wrong, cancel, refresh the page, and scan a fresh QR. Wrong-network payments are a common reason sites never detect your transfer — see switch Phantom to mainnet.
3. Paid but the site did not detect it
Solana Pay sends SOL on-chain immediately, but the website learns about it by polling the blockchain — that can take a few seconds. On Garden Dice and challenge pages:
- Return to the same browser tab where you opened the QR (do not close it).
- Tap I've paid — detect and roll and wait 5–15 seconds.
- If still stuck, open wallet Activity, copy the transaction signature, and paste it into the fallback field.
- Confirm the transfer on verify a Solana payment or our transaction lookup tool.
If Solscan shows Success to the correct address but the site still fails, refresh once and paste the signature — the payment is not lost.
4. In-app browsers (Twitter, Discord, Telegram)
Embedded browsers inside social apps often block wallet extensions and mishandle
solana: deeplinks. Symptoms: blank page after scan, or wallet never opens.
- Tap the browser menu and choose Open in Safari or Open in Chrome.
- Navigate to the pay tab again and scan the QR from your wallet app.
- After paying, switch back to the external browser tab to detect the roll.
Desktop users: skip QR entirely — use the Wallet tab with a browser extension. See connect Phantom to a dApp.
5. Retry Solana Pay on Garden Dice
Once your wallet is on mainnet with enough SOL for payment + fee:
- Try the free demo above — no wallet needed.
- In the pay panel, open the Solana Pay tab (not Wallet on mobile).
- Scan with Phantom or Solflare, approve 0.001 SOL, return and tap detect-and-roll.
FAQ
Is Solana Pay the same as wallet connect?
No. Wallet connect runs inside the browser tab. Solana Pay opens your phone wallet app via QR or deeplink — better for mobile when extensions are unavailable.
Will I be charged twice if detection failed?
Each approval is a separate on-chain transfer. If detection failed but the first tx succeeded, paste that signature instead of paying again. Failed wallet previews do not debit SOL.
Does Solana Pay need extra SOL for fees?
Yes — same as any transfer. Keep about 0.00001 SOL above the payment amount. See transaction fees explained.
What if Phantom says transaction failed?
That covers wallet-side errors (cancelled, insufficient, wrong network). See fix Phantom transaction failed, fix Solflare transaction failed, or fix Backpack transaction failed for the full checklist.