Developers
The crypto API.
One POST. Any of 12 chains. A signed webhook when it confirms. From 1%.
Create a charge
Charge in dollars. Get an address.
Amount in cents. Quoted at spot, rounded up, held for your window.
Request
curl https://sainto.io/api/v1/charges \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{
"reference": "order-1001",
"amount": 2500,
"chain": "base",
"asset": "USDC",
"return_url": "https://yourstore.com/thanks",
"metadata": { "order_id": "1001" }
}'Response · 201
{
"id": "ch_9f2c4a71d0e8b3c5a6d7e8f9",
"object": "charge",
"status": "pending",
"amount": 2500,
"currency": "USD",
"chain": "base",
"asset": "USDC",
"address": "0x742d…f44e", // pay-in address for this charge
"units": "25", // what the customer must send
"unit_price": "1.00000000",
"fee": 25, // 1%, in cents
"net": 2475,
"confirmations": 0,
"confirmations_required": 30,
"expires_at": "2026-09-26T18:12:00.000Z"
}Reference
Six endpoints. One key.
Bearer keys from the console. Test keys and a simulate call. Rate limited per key. Errors say what to fix.
POST
/v1/chargesQuote a payment. The same reference twice returns the first charge, so retries are free.GET
/v1/chargesThe most recent charges. Filter with ?status= and ?limit=.GET
/v1/charges/:idOne charge, by our id or your own reference.POST
/v1/charges/:id/cancelCancel one that is still pending.POST
/v1/charges/:id/simulateTest mode only: pretend the chain paid it, and drive your integration to “paid”.GET
/v1/chainsWhat this account can take right now, and why anything is unavailable.Webhooks
Told the moment it confirms.
HMAC over <timestamp>.<body>. Refuse anything older than five minutes. Retries for six hours.
charge.confirmedConfirmed to that chain’s depth — release the order.charge.underpaidLess arrived than was quoted. Nothing is released.charge.expiredThe quote window closed with nothing received.charge.createdA charge was quoted. Only sent to endpoints that ask for every event.
Verifying a webhook
// Node — the same three lines in any language
import { createHmac, timingSafeEqual } from 'node:crypto';
const ts = req.headers['x-sainto-timestamp'];
const sig = req.headers['x-sainto-signature'];
if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) throw new Error('stale');
const expected = createHmac('sha256', process.env.SAINTO_WEBHOOK_SECRET)
.update(`${ts}.`).update(rawBody).digest();
if (!timingSafeEqual(Buffer.from(sig, 'hex'), expected)) throw new Error('bad signature');Chains
12 chains.
What your account can take right now: GET /v1/chains.
Bitcoin2 confirmations · about 20 minutesBTC
Ethereum12 confirmations · about 3 minutesUSDT, USDC, ETH
Base30 confirmations · about a minuteUSDC, ETH
Polygon60 confirmations · about two minutesUSDT, USDC, MATIC
Arbitrum20 confirmations · under a minuteUSDC, USDT, ETH
Optimism20 confirmations · under a minuteUSDC, ETH
BNB Chain15 confirmations · under a minuteUSDT, USDC, BNB
Avalanche20 confirmations · under a minuteUSDC, USDT, AVAX
Litecoin6 confirmations · about 15 minutesLTC
XRP Ledger1 confirmations · a few secondsXRP
Tron20 confirmations · about a minuteUSDT
Solana32 confirmations · under a minuteUSDC, SOL
Stores
Plugins.
WooCommerce
Registers the gateway, charges at checkout, completes the order on the webhook. Plugins → Add New → Upload, then paste a key.
Download the pluginShopify
No native gateway yet. Add a manual payment method, link it to your Sainto payment page, and mark orders paid from the webhook.
Talk to us about Shopify