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 plugin
Shopify

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

Get paid in crypto. Today.

From 1%. 12 chains. No chargebacks.