Skip to content

Test and Live

Every Sotirea customer has up to two organisations: a Test one, created when you sign up, and a Live one, created when Sotirea approves your application to handle real money. They have the same name and you switch between them in the console, but they are separate organisations with separate vaults, keys, balances and history. Nothing you do in one can touch the other.

Test Live
Money Test coin, worth nothing Real assets
Networks Test networks, such as Sepolia and Base Sepolia Their real counterparts, such as Ethereum and Base
API keys Start sot_test_ Start sot_live_
New addresses Can be paid at once Wait 24 hours after approval, by default
Created When you sign up When Sotirea approves you

Everything else works the same way: the same API, the same clients, the same webhooks, the same rules and approvals. An integration built against Test runs against Live with the key changed and the network ids swapped for their Live counterparts.

A key reaches only its own organisation. A key whose prefix does not match its organisation is refused as invalid, and every request that moves money checks that the network belongs to the organisation’s environment: a Test organisation cannot pay on a Live network, or the other way round.

GET /v1/me says which organisation a key reaches, and GET /v1/networks lists the networks it can use, with each one’s coin, recognised tokens and how long it takes to make a payment final.

Each Live network has a test network beside it that behaves the same way, so what you see in Test, such as how long a deposit takes to become final, holds in Live.

Live network Its test network
Ethereum eip155:1 Sepolia eip155:11155111
BNB Smart Chain eip155:56 BSC testnet eip155:97
Base eip155:8453 Base Sepolia eip155:84532
Arbitrum eip155:42161 Arbitrum Sepolia eip155:421614
Robinhood Chain eip155:4663 Robinhood Chain testnet eip155:46630
Arc eip155:5042 Arc testnet eip155:5042002

Which of them your organisation can use right now is whatever GET /v1/networks answers. Read it rather than hard-coding the list: Sotirea adds networks over time, and a network can be paused for a while.

Live opens after Sotirea has reviewed your organisation. Someone who can manage the organisation applies from Go live in the Test console, by providing:

  • your certificate of incorporation;
  • your registered address;
  • your directors and authorised signatories;
  • your beneficial owners;
  • what you intend to use Sotirea for.

Files can be PDF, JPEG or PNG, up to 10 MB each. You can submit once every item is there, and you cannot change what you sent while it is being reviewed. Sotirea then approves, declines with a reason, or asks you for one specific thing, by email; you answer it in the console and the review carries on.

Approval creates your Live organisation, linked to your Test one, and brings across how you have organised yourselves:

  • your roles, and the people who hold them. A role that moves money or controls access waits for a second person to confirm it again in Live, as any such grant does;
  • your organisation-wide payment rule, with its wait for new addresses raised to at least 24 hours;
  • addresses you approved for every network. Each waits out the Live delay before it can be paid.

It does not bring across anything that touches money or your systems: API keys, webhooks, vaults, network-specific rules and addresses, balances and history stay in Test. Create Live keys and webhooks, and open your Live vaults, once you are approved.