Fivo Documentation

Accept stablecoin payments across 9 blockchains with a single integration. No crypto expertise required.

Quick Start

Get started in 5 minutes with our copy-paste widget

API Reference

Full API documentation for custom integrations

What is Fivo?

Fivo is a multi-chain stablecoin payment gateway that allows merchants to accept USDC and EURC payments from customers on any supported blockchain. Powered by Circle's infrastructure and CCTP (Cross-Chain Transfer Protocol), Fivo automatically handles cross-chain USDC transfers when a customer pays from a different blockchain than the merchant's receiving wallet. EURC payments are supported on the same chain only.

Key Features

Stablecoin Payments

Accept USDC (all 9 chains) and EURC (Ethereum, Avalanche, Base) - stable currencies pegged to USD and EUR. No price volatility, instant settlement.

Multi-Chain Support

Support payments from 9 blockchains: Ethereum, Polygon, Avalanche, Arbitrum, Base, Optimism, Linea, Unichain, and Sonic.

Automatic Cross-Chain

CCTP technology automatically bridges USDC payments to your preferred blockchain. No manual bridging needed. EURC is same-chain only.

Secure Wallets

Powered by Circle Programmable Wallets. Fivo does not hold private keys. All wallets are managed by Circle's infrastructure.

Automated Invoicing

Every withdrawal generates a professional invoice with fee breakdown, PDF attached to email and downloadable from your dashboard.

Fees & Pricing

Fivo Fee

0.5% per withdrawal. No monthly fees, no setup fees, no hidden costs. You only pay when you withdraw.

Network Gas

Layer 2 chains (Base, Polygon, Arbitrum, etc.): fixed $0.01 per withdrawal. Circle handles the gas and Fivo charges a flat fee. Ethereum L1: real-time estimation + 20% safety buffer, with adjustments settled on subsequent withdrawals.

Taxes

Spain: 21% IVA on the Fivo fee. EU: reverse charge (0%). Non-EU: exempt (0%). Calculated automatically from your billing data.

Supported Blockchains

USDC is available on all 9 chains. EURC is available on Ethereum, Avalanche, and Base. Cross-chain transfers (CCTP) are supported for USDC only.

Ethereum

Chain ID: 1CCTP: 0Tokens: USDC, EURC

Polygon

Chain ID: 137CCTP: 7Tokens: USDC

Avalanche

Chain ID: 43114CCTP: 1Tokens: USDC, EURC

Arbitrum

Chain ID: 42161CCTP: 3Tokens: USDC

Base

Chain ID: 8453CCTP: 6Tokens: USDC, EURC

Optimism

Chain ID: 10CCTP: 2Tokens: USDC

Linea

Chain ID: 59144CCTP: 11Tokens: USDC

Unichain

Chain ID: 130CCTP: 10Tokens: USDC

Sonic

Chain ID: 146CCTP: 13Tokens: USDC

Blockchain	Chain ID	CCTP Domain	Tokens
Ethereum	`1`	0	USDC, EURC
Polygon	`137`	7	USDC
Avalanche	`43114`	1	USDC, EURC
Arbitrum	`42161`	3	USDC
Base	`8453`	6	USDC, EURC
Optimism	`10`	2	USDC
Linea	`59144`	11	USDC
Unichain	`130`	10	USDC
Sonic	`146`	13	USDC

How It Works

Customer clicks "Pay with Fivo"

The payment widget opens and scans the customer's wallet for USDC/EURC balances across all supported chains.

Customer selects payment source

The customer chooses which blockchain to pay from. The widget shows gas costs and any bridging fees upfront.

Transaction is processed

If same-chain: instant transfer. If cross-chain (USDC only): CCTP burns tokens on source chain and mints on destination chain (typically 1-2 minutes).

Merchant receives payment

Funds arrive in the merchant's wallet. Email notification is sent with transaction details.

Ready to get started?

Follow our Quick Start guide to accept your first payment in under 5 minutes.

Quick Start Guide