Skip to main content

Troubleshooting

If something isn't working, find the closest match below. If none of these help, open an issue on the recoil-pay-v2 repository.


The intent bar shows "NLP parsing unavailable"​

What it means: the language model that reads your sentence isn't reachable right now.

Try:

  • Refresh the page.
  • Wait a minute and try again — Hugging Face's free inference API occasionally throttles.
  • If it persists, the issue is on our side. Check the recoil-pay-v2 issues page or reach out.

"Couldn't reach the solver network. Retry in a moment."​

What it means: the aggregator (the service that finds you a quote) isn't responding.

Try:

  • Refresh the page.
  • Check your internet connection.
  • Wait a minute — the aggregator may be restarting.

"Chain 'X' isn't supported yet"​

What it means: RecoilPay understood which chain you asked for, but it isn't in the live route set.

Fix: use one of the Supported networks.


"Token 'X' isn't recognized"​

What it means: you typed a symbol RecoilPay doesn't know.

Fix: check the spelling. If you meant USDC, USDT, or ETH, use those exact names. See Writing intents → What RecoilPay understands.


"USDC isn't supported on X yet"​

What it means: the token exists and the chain exists, but no solver covers that specific combination.

Fix: try a different chain — every supported chain has USDC. See Supported networks.

If you wrote Base, BSC or another plain chain name, RecoilPay read it as the mainnet, which isn't live. Name the testnet: base sepolia, bsc testnet.

Cash-outs and purchases only work on Base Sepolia, Polygon Amoy, BNB Chain Testnet, Avalanche Fuji and Solana devnet. See What works where.


"No solver returned a quote for this route yet"​

What it means: every solver either timed out or refused to quote this pair right now. Usually this is temporary.

Try:

  • Wait 30 seconds and re-submit the same sentence.
  • Try a smaller amount — some solvers reject amounts above their inventory.
  • Try the reverse direction — sometimes one direction has liquidity and the other doesn't at that moment.

"The quote expired and no fresh quote is available"​

What it means: you took long enough between the quote and confirming that the quote expired, and when the app tried to fetch a new one, no solver responded.

Fix: click Cancel and re-submit the sentence.


My wallet won't connect​

Try, in order:

  1. Make sure your wallet extension is unlocked.
  2. Refresh the page.
  3. Disconnect any existing session in your wallet (Connected sites → find v2.recoilpay.com → disconnect), then reconnect.
  4. Try a different browser or a different wallet (see Wallet setup for supported options).

The app wants me to switch networks​

That's normal. RecoilPay needs your wallet to be on the source chain (the chain the input token lives on) before you can sign.

Approve the switch prompt. If your wallet doesn't have the destination chain, add it — see Supported networks → How to add a chain to your wallet.


The approval transaction is taking forever​

Testnet chains can occasionally be slow. Don't refresh — the transaction is in flight.

  • Open your wallet and check the transaction status.
  • Some wallets let you speed up the transaction by paying more gas. On testnet this is fine.
  • If the transaction shows as dropped or failed in your wallet, close the confirm card in RecoilPay and try again.

The status is stuck on "pending"​

What it means: the solver has seen your intent but hasn't filled it yet. Usually this resolves in seconds. If it's been longer than a couple of minutes:

  • The solver may be out of inventory on the destination chain — try a different destination.
  • The solver may have crashed — try re-submitting.

Your funds are safe either way. If the intent fails, your input is refunded.


The status shows "failed"​

Something went wrong on the solver side. Your input has been (or will be) refunded — nothing was lost.

Click Dismiss and try again. If it fails a second time, try:

  • A smaller amount.
  • A different chain pair.
  • Wait a few minutes.

If it keeps failing, open an issue with the sentence you typed and (if you have it) the order id from the status card.


I don't see my testnet USDC in my wallet​

Your wallet might not know about the mock USDC token. Add it manually:

  1. In your wallet, find Import token (in MetaMask: Assets → Import tokens → Custom token).
  2. Paste the USDC address for your current chain (see Supported networks → USDC contract addresses).
  3. Symbol: USDC, decimals: the value listed for your chain (6 on every testnet today).

The wallet should now show your balance.


"To receive on Solana, connect a Solana wallet or name a Solana address to send to"​

Your EVM wallet can't receive on Solana, and RecoilPay won't guess. Either connect a Solana wallet (Connect Wallet → Solana, see Solana wallets), or say where to send it: send 5 USDC on base sepolia to solana to <solana address>.


"To pay from Solana, connect a Solana wallet"​

A swap from Solana is paid by your Solana wallet: it signs the transaction that locks your USDC in the escrow. Connect one with Connect Wallet → Solana (see Solana wallets), then try again.


"Swaps within Solana aren't available"​

RecoilPay moves USDC between Solana and the EVM testnets, not from one Solana address to another. Use your Solana wallet to send it directly.


My swap to Solana says "filled" but not "settled"​

That's expected, for a while. Your USDC is already in your Solana wallet. "Settled" means the solver has been repaid from your escrow, which waits for proof of the delivery to cross from Solana to the source chain. That usually takes 2 to 20 minutes. See Fees and timing.


My swap from Solana never arrived​

If no solver filled it, nothing left the escrow except back to you: 30 minutes after the quote, RecoilPay refunds the escrow to your Solana wallet automatically, usually within a minute of that. Check the wallet on devnet. If it's been more than an hour and the USDC is in neither place, open an issue with the order id.


I don't see the USDC in my Solana wallet​

  • Check the wallet is on devnet. In Phantom, turn on Testnet mode and choose Solana Devnet; on mainnet the balance is somewhere else entirely.
  • Check the address on the confirm card is the one you expected.
  • Look the address up on the Solana explorer (devnet). The USDC mint is 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU.

Nothing is happening when I click "Confirm"​

Look at the top-right of your browser — most wallet extensions surface a small notification badge when they're waiting for you.

Click your wallet icon. If there's a queued request, approve or reject it. RecoilPay can't proceed until that queue is clear.


"No solver is cashing out USDC on … right now"​

What it means: no solver has a live cash-out offer for that chain and amount. You'll see a similar message for purchases ("No solver is selling …").

Fix: try the other chain, or a smaller or larger amount, since each offer has a minimum and a maximum. Solvers publish offers by hand, so coverage changes through the day.


"Cash-outs aren't available on … yet"​

What it means: that chain has no fiat escrow, so naira can't move there yet, even if you can swap on it. You'll see "Purchases aren't available on … yet" for a purchase.

Fix: name one of the chains in What works where, or swap to one first.


"That is above the ₦… limit for one purchase"​

What it means: purchases are capped at ₦500,000 each and ₦1,000,000 in any 24 hours for a verified person. Cash-outs are capped at ₦750,000 each and ₦1,500,000 a day.

Fix: split the amount, or wait until earlier trades are more than 24 hours old.


"Connect a Solana wallet that can sign to cash out from Solana"​

A cash-out or purchase on Solana is signed by a Solana wallet set to devnet. Connect one: in the RecoilPay app, choose Connect Solana wallet; in other apps, look under Solana wallets in the wallet picker. You'll see "Connect a Solana wallet to buy on Solana" for a purchase. See On Solana.


"… changed the transaction while signing it, so it can't be used"​

Some Solana wallets add a priority fee to a transaction as they sign it. The lock for a cash-out must be exactly the transaction you were shown, so a changed one is refused before anything is sent. Turn off the wallet's priority-fee setting and try again. You don't need SOL for the fee: the solver pays it.


The identity check won't finish​

  • "The Dojah window was closed." Choose Reopen Dojah and finish the check, or Start the check again.
  • Dojah sent you to your phone. Finish there, then come back to the page and choose I've finished.
  • "Dojah is reviewing your check by hand." That's normal for some checks. Leave the page open and it carries on by itself.
  • Your identity is already used with three wallets. Each identity can verify up to three wallets. Buy from one of those.

I paid, but the purchase still says "Waiting for the solver"​

The solver has 30 minutes from when you clicked I've paid to check its account. If it doesn't answer in that time, the USDC is released to you automatically. If the solver says your payment never arrived, an admin reviews the trade. Keep your bank's receipt and the payment reference.


"No merchant is buying a … right now"​

What it means: no merchant has a live offer for that exact card: brand, country, card type and face value.

Fix: open the Market to see what's on offer. A different face value or card type often finds a merchant.


"Could not open this code"​

The code is encrypted to the wallet that funded the trade. Connect that wallet and choose Reveal code again.


Something else​

If none of these describe what you're seeing:

  • Take a screenshot including any error text.
  • Note the sentence you typed and the chains involved.
  • Post them in the Testing topic of the RecoilPay group on Telegram. How to report a problem lists what helps us most.

We fix reported issues fast — you're helping the whole community when you report one.