Skip to main content

​
Overview

Exercise a complete settlement on testnet — from quote to release — to confirm your agent is configured, funded, and winning payments before you move to mainnet.
Celo and Tron are used here as an example. Atum supports many additional EVM networks, plus Solana, with more chains on the way — see Supported mainnets.
1

Configure the corridor

Point the agent at a testnet corridor.
2

Start the agent

Bring the agent online and confirm it subscribes to requests.
3

Submit a test payment

Send a payment through the gateway for the agent to fulfill.
4

Monitor the settlement

Watch the agent quote, win, and settle on-chain.

​
Prerequisites

Complete the Integration guide first — the agent should build, start, and pass ./test-setup.sh.
Gas and tokenized money on both chains in the corridor. See Settlement testnets for networks, assets, and faucets.

​
1. Configure the testnet corridor

Point the agent at a testnet corridor. This example uses Celo Sepolia ↔ Tron Shasta. For the CAIP-19 asset identifiers, see Settlement testnets.

​
2. Start the agent

Start the agent with the testnet configuration and confirm it connects to the gateway:
The logs should show the agent connecting to the gateway and subscribing to payment requests.

​
3. Submit a test payment

Submit a payment request through the Payment Gateway for your agent to fulfill. The quickest way is the CLI — see Using the CLI — or the Payment Gateway API directly. Send a payment on the corridor your agent subscribes to (for example, USDC on Celo Sepolia → USDC on Tron Shasta) so your agent is eligible to quote.

​
4. Monitor the settlement

Watch the agent quote and execute. In the logs, look for:
  • Quote submission
  • Quote selection
  • Deposit transaction
  • Fulfillment transaction
  • Release transaction
On the block explorers, deposit and release appear on the source chain; fulfillment appears on the destination chain.

​
Success criteria

The flow works end to end when:
  • The agent logs a quote and that quote is selected
  • Deposit and release transactions confirm on the source chain
  • The fulfillment transaction confirms on the destination chain
  • The payment reaches completed status on the gateway

​
Troubleshooting

Ensure wallets hold enough gas tokens for fees and enough tokenized money for fulfillment on the destination chain.
Testnet faucets can be rate-limited. Wait and retry, use a different wallet address, or ask in Discord for testnet tokens.
Common causes are insufficient gas and unreliable RPC endpoints. Use a paid RPC provider if public endpoints are flaky.
Pricing may be uncompetitive. Consider lowering the markup in your bidding strategy, check logs for selected quote amounts, and confirm the agent responds quickly.

​
Next steps

Ready for mainnet? Email support@atum.xyz before deploying to mainnet. You’ll need a production gateway URL, mainnet RPC endpoints, and sufficient mainnet liquidity.