FivoDocs
Docs/Testing

Testing

Verify your integration with real micro-payments before going live.

How Testing Works

Fivo processes real payments on mainnet. To test your integration, use the button in your page. It opens a real checkout pre-set to $0.01 USDC or EURC using your Merchant ID.Try it liveIntegration

i

Real payments, minimal cost

Each test costs $0.01 plus a small gas fee (network transaction cost). This is the safest way to confirm everything works end-to-end before accepting larger payments.

Using "Try it live"

1

Open Integration page

Go to in your dashboard and click the button.IntegrationTry it live

2

Connect your wallet

Connect MetaMask, Coinbase Wallet, or any WalletConnect-compatible wallet. Make sure it holds USDC or EURC.

3

Complete the $0.01 payment

Select a chain where you have USDC or EURC and confirm the transaction.

4

Verify the result

Check your page for the new payment and confirm you received the email notification.Transactions

What to Test

We recommend verifying these scenarios:

Same-chain payment

Pay from the same blockchain as your merchant wallet. This is the fastest flow. The transfer is instant.

Cross-chain payment (USDC only)

Pay from a different chain than your merchant wallet. Bridge Kit automatically bridges USDC via CCTP to your chain (typically 1-2 minutes). Note: EURC does not support cross-chain: it is same-chain only.

Insufficient balance

Try to pay from a chain where you don't have enough funds. The widget should show an "Insufficient" badge on that chain and prevent selection.

Transaction rejection

Click "Pay" and then reject the transaction in your wallet. The widget should show an error and allow you to retry.

Pre-Launch Checklist

Before announcing your integration, verify these items:

Debugging

If something isn't working, check these common issues:

Widget doesn't load

  • Check browser console for errors
  • Verify the script URL is correct: checkout.fivo.finance/v1/fivo.js
  • Ensure is a valid ID (format: )merchant-id (fivo_live_UUID)

No balances showing

  • Ensure your wallet has USDC or EURC on a supported chain
  • Wait a few seconds for the balance scan to complete
  • Check that your wallet is connected

Transaction fails

  • Ensure you have enough native tokens for gas (ETH, MATIC, AVAX, etc.)
  • Check that you have enough USDC or EURC for the payment amount
  • Try refreshing the page and reconnecting your wallet

Cross-chain payment is pending

  • CCTP cross-chain transfers typically take 1-2 minutes
  • During network congestion, it may take longer
  • Check payment status in your pageTransactions

Console Logs

The widget logs useful information to the browser console (press F12 to open). Look for messages starting with :[Fivo Widget]:

Browser Console
[Fivo Widget] Configuration loaded: {merchantId: "fivo_live_...", amount: "29.99", currency: "USDC", mode: "fixed"}
[Fivo Widget] Using URL/default config: {merchantId: "fivo_live_...", amount: "0.01", currency: "USDC"}

If you see error messages like , verify that your Merchant ID follows the format .Invalid Merchant ID format, fivo_live_UUID.

Need Help?

If you're stuck or found a bug, we're here to help.

Contact Support