Payment rails
A payment rail is a network that moves value according to its own rules, speeds, and costs. ACH, SWIFT, FedWire, and Visa are all payment rails. Arbitrum, Solana, and Tron are also payment rails — they run tokenized currency instead of traditional bank balances, but the core concept is the same. Each rail is independent. A balance on Arbitrum is a completely separate balance from one on Tron — the same way an ACH account and a SWIFT correspondent account are separate, even if both hold dollars. Atum’s job is to move value between rails without you having to manage correspondent relationships or intermediary routing on each one. Learn more: What is a blockchain? (Investopedia)Tokenized currency
Tokenized currency is a digital representation of a fiat currency that lives on a payment rail. USDC (issued by Circle) and USDT (issued by Tether) are both dollar-denominated tokenized currencies — always worth $1, always redeemable, and transferable on any rail that supports them. Think of them like branded forms of digital cash: the same way Visa and Mastercard both move dollars but through different networks, USDC and USDT both represent dollars but are issued by different entities and may be available on different rails. Atum coordinates the movement of tokenized currency between rails. You tell it which token you’re sending from and which the recipient gets. Learn more: What is a stablecoin? (Investopedia)Accounts and addresses
An account on a payment rail is identified by an address — a unique string (typically0x… on most rails) that works like a routing and account number combined. It’s public and safe to share.
The sender and recipient can be the same address — that’s the setup used in the sandbox quickstart.
Popular account apps: MetaMask (most rails) · Phantom (Solana) · TronLink (Tron)
Payment authorization
Before Atum can move funds from a sender’s account, that account must grant one-time authorization — similar to setting up a direct debit mandate or enabling ACH pull. You set it up once per account and token; each payment still requires a separate signature. The CLI and SDK handle this step for you automatically.Technical details: Permit2
Technical details: Permit2
Atum uses Permit2 — a widely adopted spending authorization contract originally built by Uniswap. It’s a single on-chain transaction per wallet and token that approves the Atum escrow contract to spend on your behalf. Read the Permit2 announcement →
How an Atum payment differs from a direct transfer
A direct on-chain transfer is one step: sender pushes tokens to recipient. Atum works differently:- Your app signs a payment request — who pays, from which rail, to which recipient
- Atum finds a settlement provider, coordinates delivery, and handles all the routing and settlement steps
- You get a settlement receipt with confirmation references from both rails
Currency identifiers
The API identifies each token by rail and contract address, combined into one string:Technical name: CAIP-19
Technical name: CAIP-19
Network processing fees (gas)
Network processing fees (gas)
Every on-chain action on most rails costs a small network processing fee — called “gas” — paid in the rail’s native token. On Arbitrum or Base, that’s ETH. On Tron, it’s TRX. On Solana, it’s SOL.The settlement provider holds gas for moving the funds. That is the ongoing fee on each payment.The sender needs gas only once: a one-time token approval on EVM and Tron, before the first payment of that token. Later payments are signatures — they do not spend the sender’s gas. Solana does not need that approval. The recipient never needs gas.
Learn more: What is gas? (ethereum.org)
Next steps
Quick start
Set up sandbox, send your first payment
What is Atum?
Protocol overview and where Atum fits in your stack