Skip to main content
If you’ve worked with ACH, SWIFT, or card networks, you already have the mental model you need to use Atum. This page maps Atum’s concepts to what you likely already know.

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 (typically 0x… 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.
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:
  1. Your app signs a payment request — who pays, from which rail, to which recipient
  2. Atum finds a settlement provider, coordinates delivery, and handles all the routing and settlement steps
  3. You get a settlement receipt with confirmation references from both rails
You never push tokens directly. You sign the request and poll for a result. Learn more: Atum payment lifecycle

Currency identifiers

The API identifies each token by rail and contract address, combined into one string:
That is USDC on Arbitrum Sepolia. Always copy these identifiers from Supported networks — using an address from the wrong rail will cause your payment to fail.
This format follows CAIP-19 — a standard for identifying tokens across chains. Rail IDs use CAIP-2 format.
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