Get Started
Back to Docs

Troubleshooting

Common issues and solutions for Yeld.

Quick Troubleshooting Checklist

Payment Not Showing in Dashboard

High Priority

Steps to Resolve:

  1. Check the transaction hash on BaseScan (or the relevant block explorer)
  2. Verify the transaction status is confirmed
  3. Allow up to 2 minutes for the payment to appear in your dashboard
  4. Check that the payment was sent to the correct address
  5. Verify the correct network was used (Base Sepolia, not mainnet)
  6. If the transaction is confirmed but not showing, contact support with the tx hash
You can check transactions at https://sepolia.basescan.org

Transaction Failed Error

High Priority

Steps to Resolve:

  1. Check if you have sufficient USDC balance in your wallet
  2. Verify you're sending the correct token (USDC, not ETH or other tokens)
  3. Ensure you're on the correct network
  4. Check if the transaction requires more gas than available
  5. Try increasing the gas limit if the transaction is stuck
  6. Verify the recipient address is correct
Always send USDC, not ETH. ETH is used for gas fees only.

Checkout Link Not Working

Medium Priority

Steps to Resolve:

  1. Verify the checkout link was created successfully
  2. Check if the link has expired (links don't expire by default)
  3. Ensure the business still exists and is active
  4. Check if the plan has stock available (if stock is configured)
  5. Try creating a new checkout link
  6. Clear your browser cache and try again
You can test checkout links in incognito/private mode to avoid cache issues.

API Returns 401 Unauthorized

High Priority

Steps to Resolve:

  1. Verify your API key is correct and not expired
  2. Check that the API key is included in the Authorization header
  3. Ensure the API key format is correct (Bearer YOUR_API_KEY)
  4. Try regenerating your API key from the dashboard
  5. Check if your API key has the necessary permissions
  6. Verify you're using the correct API version in the URL
API keys are case-sensitive. Copy them exactly as shown.

Cannot Connect Wallet

Medium Priority

Steps to Resolve:

  1. Ensure your wallet is unlocked
  2. Check that you're on the correct network in your wallet
  3. Try disconnecting and reconnecting your wallet
  4. Clear browser cache and cookies
  5. Try a different browser or device
  6. Update your wallet extension to the latest version
MetaMask and Rainbow are recommended wallets for Yeld.

Database Connection Error

High Priority

Steps to Resolve:

  1. Verify your Supabase URL and API keys are correct
  2. Check that your database is not paused or deleted
  3. Ensure your IP is whitelisted (if you have IP restrictions)
  4. Restart your development server
  5. Check your internet connection
  6. Look at Supabase logs for database errors
Run 'npx drizzle-kit studio' to view your database.

Error Code Reference

Common error codes and how to resolve them.

ERR_MNEMONIC_MISSING

EVM_MASTER_MNEMONIC is not set

Add your master mnemonic to the .env.local file. Generate one with: openssl rand -hex 32

ERR_DB_CONNECTION

Cannot connect to database

Verify your Supabase credentials are correct in .env.local. Check your internet connection.

ERR_INVALID_PRICE

Enter a valid price

Ensure the price is a valid number greater than 0. Remove any currency symbols or commas.

ERR_NOT_AUTHORIZED

Business not found or not authorized

Ensure you're signed in and own the business. Check that the business ID is correct.

ERR_NETWORK

Network request failed

Check your internet connection. If using a testnet, ensure the network is accessible.

Getting Help

If you've followed the troubleshooting steps and still need help:

Before Contacting Support

  • Include the error message or code
  • Describe what you were trying to do
  • Include relevant transaction hashes or IDs
  • Note when the issue started

Contact Options

  • Email: support@yeld.app
  • Dashboard: Settings → Support
  • Response time: Within 24 hours

Preventive Measures

  • Regular Backups

    Backup your master mnemonic securely. Store it in multiple safe locations.

  • Test on Testnet First

    Always test changes on Base Sepolia before deploying to production.

  • Monitor Logs

    Keep an eye on your server logs and dashboard for unusual activity.