Suward Documentation

Accept stablecoins across 7 EVM networks through one REST API. Every payment gets its own deposit address, climbs Pending → Safe → Finalized, and settles into a balance you can read. The fee is 0.4% + min $1, with nothing hidden in the spread. Everything documented here ships in the code; anything still on the roadmap wears a Soon label.

PendingSafeFinalized

Open Quickstart API Reference

curl -X POST https://api.suward.com/v1/projects/{projectId}/payments \
  -H "X-Api-Key: <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"amount":"100.00","asset":"USDT","externalId":"order-42"}'

Three ways to start tonight

Quickstart

Your first payment in 15 minutes. Create a payment, get a unique address, poll the status to finality.

API Reference

All 59 REST endpoints, with request and response schemas from the OpenAPI spec.

Sandbox

Try the hosted checkout, no signup. Watch a test payment move through the lifecycle before you write a line of code.

Browse the docs

Start at the top and work down, or jump to the part you need.

Quickstart

From signup to a confirmed payment in one evening, with real curl and JavaScript snippets.

Authentication

Two ways in: a cookie session for the dashboard, and the X-Api-Key header for server-to-server calls.

Payments

Create a payment, hand the customer a unique address, then poll the status as it climbs Pending → Safe → Finalized.

Assets & Networks

22 assets across 7 EVM networks. Each network carries its own confirmation threshold and contract addresses.

Hosted Checkout

Redirect the buyer to a ready payment page with a QR address and a countdown, or wire your own UI to the same payment.

Balances

Stored as Decimal128 and split into safe and accepted. Atomic on every credit, and they never go negative.

Withdrawals

A withdrawal goes through operator review with a fee quote attached. On-chain auto-payout is still on the roadmap.

Errors

Error codes, idempotency, and rate limits in one place, so a retried request never double-charges.

Webhooks

Soon

Not in the API yet. Today you poll GET /v1/payments/{id} for status. This section links to the honest roadmap, not endpoints that do not exist.

API Reference

The full surface: 59 endpoints, parameters, and example payloads.

In development

These features are not in the API yet. Listed here plainly so you can plan your integration around what actually ships today.

Soon

Webhooks

In development. For now, poll payment status through the API with GET /v1/payments/{id}.

Soon

Analytics & CSV reports

On the roadmap.

Soon

Live events (SSE)

Planned.

Soon

Auto-payouts

Today a withdrawal goes through operator review; on-chain auto-payout is planned.

Subscribe to updates