Quickstart
Add pay-per-call pricing to an API in five minutes with the test rail. No wallet or account.
Pre-release · planned API
This guide prices a Hono route with the test rail and memory ledger, so there is nothing to sign up for.
1. Install
npm install tollstile @tollstile/hono honoOr start from a template: npx create-tollstile my-paid-api.
2. Price a route
import { Hono } from "hono";
import { createTollstile, memoryLedger, testRail } from "tollstile";
import { tollstile } from "@tollstile/hono";
const toll = createTollstile({
rails: [testRail()],
ledger: memoryLedger(),
});
const app = new Hono();
app.get("/weather", tollstile(toll.price("$0.01")), (c) => {
return c.json({ forecast: "clear" });
});
export default app;3. Call it without paying
curl -i localhost:3000/weatherHTTP/1.1 402 Payment Required
{
"error": "payment_required",
"price": "$0.01",
"quote": "eyJ2IjoxLCJpZCI6…",
"accepts": [{ "rail": "test", "amount": "10000", "flow": "authorization", … }]
}The quote is a signed record of what the server offered. It is never stored.
4. Pay with the quote
curl -i -H "Payment: test quote=eyJ2IjoxLCJpZCI6…" localhost:3000/weatherHTTP/1.1 200 OK
payment-receipt: test_settlement_chg_…
{ "forecast": "clear" }The ledger now holds one authorization and one charge in settled/completed. For fixed prices, Payment: test without a quote also works.
5. Switch to a real rail
Replace testRail() with live rails and memoryLedger() with a database ledger. The route does not change.