Skip to main content
By the end of this page you will have watched the live Rail402 facilitator respond, then settled a real payment on stellar:testnet and confirmed it on the explorer. It takes about five minutes.

​
See it live, with no setup

The rail402 CLI talks to the hosted testnet facilitator by default. These read-only commands need no account and no funding.
supported prints the schemes and networks, and search returns real services from the catalog with their price and description. Nothing is paid.

​
Make your first payment

To pay, you need a funded testnet account that holds the payment asset.
1

Create and fund an account

fund generates a testnet keypair and funds it with XLM from friendbot. Save the secret it prints.
2

Add the payment asset

Bazaar services are priced in testnet USDC. Add a USDC trustline to your account, then fund it from the Circle faucet (select Stellar testnet). The trustline is a step you take yourself; the faucet only sends the USDC. See Trustlines for how to add one and why an account needs it.
friendbot funds XLM; testnet USDC comes from the Circle faucet.
3

Discover and pay

buy searches the Bazaar, picks the best-ranked match within your cap, and pays it. Amounts on the CLI are decimals, so --max 0.10 is 0.10 USDC.
It prints the settled transaction hash and the resource response.
4

Verify it on chain

Look the settlement up on the explorer.
Or open it at explorer.rail402.dev. The fee was charged to the facilitator, not to your account, because fees are sponsored.
Every command accepts --json for a machine-readable { ok, data | error } result, so an agent can drive this flow. See The rail402 CLI.

​
Build the real thing

The CLI is the fastest way to see a payment. To build a buyer, a seller, or run your own facilitator, follow the path for what you are building.

Buyers and agents

Pay for services from code with @rail402.dev/sdk.

Sellers

Put a paid, discoverable endpoint online.

Operators

Run the facilitator yourself.

​
Next steps

How Rail402 works

The payment loop, the four addresses, and exact versus upto.

Packages

Every published package and which to use.