Currencies and networks

Payments settle in the asset the payer picks, directly to the receiver's own wallet. Prices can be set in any of 161 fiat currencies and convert at a rate locked for 15 minutes.

What each network carries

Network (API value)Currencies (API values)
Bitcoin (Mainnet)BTC (Btc) on-chain, and over Lightning with paymentMethod: "Lightning"
Solana (Solana)Usdc, Usdt, Eurc, native Sol, wrapped BTC (Btc)
Ethereum (Ethereum)Usdc, Usdt, Eurc, native Eth, WBTC (Btc)
Base (Base)Usdc, Eurc, native Eth
Arbitrum (Arbitrum)native Usdc (not USDC.e), native Eth
Polygon (Polygon)native Usdc (not USDC.e)

Amounts and decimals

API amounts (amountSats, amountBaseUnits) are integers in the asset's base units.

AssetDecimalsBase unit
BTC and wrapped BTC8satoshi
USDC, USDT, EURC6micro-unit
SOL9lamport
ETH9gwei (payment links carry the value in wei)

Payment links

  • Bitcoin: BIP-21 (bitcoin:). Lightning: the invoice (lightning:).
  • Solana: Solana Pay (solana:), with spl-token for tokens.
  • EVM chains: EIP-681 (ethereum:) with chain id 1 (Ethereum), 8453 (Base), 42161 (Arbitrum) or 137 (Polygon).

Detection and confirmation

  • Payments are matched by exact amount at the receiver address, so two open payments to one address never share an amount: a fiat-priced amount may be a few base units higher than the plain conversion. Use a fresh address per payment where you can.
  • Before a payment is marked confirmed, send21 looks the transaction up once more at a second source. A payment that was replaced or reorged out sends the draft back to awaiting payment.
  • A transfer within 10% of the billed amount is recorded for the receiver to accept or decline (reviewState), never ignored and never confirmed on its own.
  • One confirmation by default; Polygon waits for 16. Solana counts finalized transactions.
  • Native ETH is detected with free sources: public block explorers where they exist, optional free-tier explorer keys, and a balance check over public RPC. A payment seen only by the balance check cannot show who sent it, so the receiver confirms it (reviewReason: balance_check).
  • Lightning is confirmed through the receiver's Lightning address when the provider supports LUD-21. See Lightning.

Test networks

The demo covers Testnet4, Signet, Solana Devnet, Ethereum Sepolia, Base Sepolia, Arbitrum Sepolia and Polygon Amoy. On send21.io the test networks are reserved for the demo; account drafts use the live networks.

Related

Start building

Create a free account to get an API key, or try the whole flow first on test networks.

This page is also available as Markdown: /docs/currencies.md. Questions: integration@send21.io.