RailPayDocs
Sandbox. No real funds move and nothing settles on a chain yet. What this means

API reference

Account

Your account and the sandbox faucet.

GET/v1/meSession or account key

The signed-in account, or { account: null }.

curl
curl https://dapp.railpay.app/v1/me \
  -H "Authorization: Bearer $RAILPAY_KEY"
GET/v1/overviewSession or account key

Balance, pockets, agents with today's spend, today's in/out/blocked totals and faucet left. Amounts in base units (6 decimals).

Response
{ "balance": 721500000, "pockets": [ … ], "agents": [ … ], "today": { "in": …, "out": …, "blocked": 1 }, "faucet_left_today": 500000000 }
curl
curl https://dapp.railpay.app/v1/overview \
  -H "Authorization: Bearer $RAILPAY_KEY"
GET/v1/statusNone

Sandbox mode and network.

Response
{ "mode": "sandbox", "network": "railpay-sandbox", "asset": "SUSD", "decimals": 6, "settlement": "not_live" }
curl
curl https://dapp.railpay.app/v1/status

API keys

GET/v1/keysSession or account key

Active keys (prefix, label, agent, created, last used). Secrets are never returned again.

curl
curl https://dapp.railpay.app/v1/keys \
  -H "Authorization: Bearer $RAILPAY_KEY"
POST/v1/keysSession or account key

Create an account key, or an agent key when agent_id is set. The secret is in the response once.

Body
{ "label": "Backend", "agent_id": "agt_… (optional)" }
Response
{ "id": "key_…", "key": "rp_sk_…", "prefix": "rp_sk_…" }
curl
curl -X POST https://dapp.railpay.app/v1/keys \
  -H "Authorization: Bearer $RAILPAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "label": "Backend", "agent_id": "agt_… (optional)" }'
DELETE/v1/keys/:idSession or account key

Revoke a key.

curl
curl -X DELETE https://dapp.railpay.app/v1/keys/<id> \
  -H "Authorization: Bearer $RAILPAY_KEY"
PATCH/v1/meSession or account key

Update name, handle or kind.

Body
{ "name": "Acme Studio", "handle": "acme", "kind": "business" }
curl
curl -X PATCH https://dapp.railpay.app/v1/me \
  -H "Authorization: Bearer $RAILPAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Studio", "handle": "acme", "kind": "business" }'
POST/v1/faucetSession or account key

Add 100 SUSD. Max 1,000 SUSD per account per UTC day.

curl
curl -X POST https://dapp.railpay.app/v1/faucet \
  -H "Authorization: Bearer $RAILPAY_KEY"

The RailPay app runs in Sandbox mode. Balances are in Sandbox USD (SUSD). No real funds move and nothing settles on a chain. Chains, stablecoins, card issuing, ramps, fees and yield are TBD.

© 2026 RailPay. Built as practical payment infrastructure, not a token or fundraising project.