Documentation
STONS documentation
Accept crypto payments through an API and pay out to whitelisted addresses. Payments work on TRON, on the EVM networks — Ethereum, BNB Smart Chain, Polygon, Base, Arbitrum, OP Mainnet, Avalanche — on TON and on Solana; payouts are made on TRON. Which assets a project can offer at a given moment is the answer of GET /v1/assets, and the “Networks and tokens” document says what the service does on each network. An invoice in a token gives you the full address and the exact amount to show on your own page; an invoice without a token is paid on the hosted checkout page, where the customer chooses the coin and the network. The service reports events with signed webhooks.
API address
https://api.stons.io/v1For Claude Code and other AI assistants
Paste this prompt into the assistant in your project. It reads the whole documentation as one file and connects payments step by step, asking you for the keys.
Files for AI assistants
Add payments through STONS to this project. Read the documentation at https://stons.io/llms-full.txt and follow the “Turnkey integration with an AI assistant” document step by step: first ask me for the API key, the webhook secret and how the payment should be shown, then implement invoice creation, a webhook handler that verifies the signature, and a status check through the API.
Getting started
- Turnkey integration with an AI assistantStart here: a glossary, what to ask the project owner, the integration steps in order with decision rules, and a self-check.
- Networks and tokensThe networks and tokens of the service, what it does on each network, why decimals differ between networks, and where the API tells which assets a project can offer.
API
- AuthenticationThe X-Api-Key header and the key format, rate limits and Retry-After, key rotation, and why the client must use https.
- InvoicesCreating and reading invoices: in a token or with the token chosen by the customer, idempotency by order_id, statuses, fees, and amounts as strings.
- Deposit addressesPermanent user addresses in per_user mode, the two address modes and a paused mode, what is credited at an address, verifying a transfer by its transaction hash, and showing an address in full.
- Checkout pageThe hosted checkout page at checkout_url: what the customer sees, the token choice, return URLs, and the signed redirect.
- WebhooksEvery event and when it is sent, the body fields, verifying the HMAC-SHA256 signature in Node.js and Python, and delivery retries.
- BalanceThe money of the project: the ledger balance of every asset, what is still unconfirmed, and the same money in dollars at accepted rates.
- PayoutsPayouts to whitelisted addresses: the request, idempotency by reference, statuses, the fee, limits, and review by a person.
- Error codesThe error body, every error.code with its HTTP status and what the client should do, and X-Request-Id.