Skip to main content

​
“Insufficient funds” Error

Problem: Your wallet doesn’t have enough SOL or USDC. Solution:
  1. Check SOL+USDC balance: https://orb.helius.dev/address/<wallet-address>/tokens
  2. Purchase and transfer more SOL or USDC to your wallet

​
”Payment failed” Error

Problem: Payment transaction failed on Solana. Solution:
  1. Ensure you have SOL for transaction fees (at least 0.001 SOL)
  2. Verify USDC balance is sufficient (at least 0.01 USDC per request, 0.001 for Nansen)
  3. Check network status at https://status.solana.com/
  4. Try again after a moment if network is congested

​
”402 Payment Required” Not Handled

Problem: Payment handler not working. Solution:
  1. Verify fetchWithPayer is being used (not regular fetch)
  2. Check that payment handler was created correctly
  3. Ensure PAYER_KEYPAIR environment variable is set
  4. Verify wallet has both SOL and USDC

​
”Could not find USDC mint” Error

Problem: lookupKnownSPLToken returned undefined. Solution:
  1. Ensure you’re using "mainnet-beta" as the network name (not “mainnet”)
  2. Check that @faremeter/info package is installed
  3. Verify the import path: @faremeter/info/solana

​
HTTP Error Responses

Problem: API returns 400, 500, or other error codes. Solution:
  1. Check the error message in response body
  2. Verify your request payload is correct for the partner API
  3. Ensure the proxy URL is correct
  4. Check partner API documentation for endpoint requirements

​
Support

For questions or issues: