Plug subscriptions into anything

# Browser — gate anything, no key needed (subscription state is public) <script src="https://subs.fi/sdk.js"></script> <script> const subs = SubsFi(); subs.gate({ subscriber: wallet, // the connected Solana / TON address object: "abc12", // your link slug onGranted: () => unlock(), onDenied: () => subs.openCheckout("abc12"), // send them to checkout }); </script>

# Backend — manage links & subscribers with a key (server-side only). # Create the key in /app, then replace YOUR_KEY / YOUR_SLUG / WALLET. curl -H "Authorization: Bearer YOUR_KEY" "https://api.subs.fi/v1/api/links" curl -H "Authorization: Bearer YOUR_KEY" "https://api.subs.fi/v1/api/subscribers?object=YOUR_SLUG" curl -H "Authorization: Bearer YOUR_KEY" "https://api.subs.fi/v1/api/access/check?subscriber=WALLET&object=YOUR_SLUG" # → { "access": true, "status": "active", "until": "…", "kind": "telegram" }

# Create a subscription link programmatically. TON links go live instantly; # Solana returns an unsigned create_plan tx for your payout wallet to sign, # then POST /v1/api/links/<option id>/confirm once it lands on-chain. curl -X POST "https://api.subs.fi/v1/api/links" \ -H "Authorization: Bearer YOUR_KEY" -H "content-type: application/json" \ -d '{"source":"https://t.me/your_channel","rail":"ton","period":"1mo", "priceDecimal":5,"kind":"telegram","chatId":"@your_channel"}' # → { "group": { "link": "https://subs.fi/abc12", "qr": "…" }, # "options": [ … ], "signatureRequired": false }

// Receive webhooks — verify the signature, then trust the payload. import { createHmac, timingSafeEqual } from "node:crypto"; app.post("/webhooks/subsfi", express.raw({ type: "*/*" }), (req, res) => { const [t, v1] = req.get("subsfi-signature").split(",").map(p => p.split("=")[1]); const expected = createHmac("sha256", process.env.SUBSFI_WEBHOOK_SECRET) .update(`${t}.${req.body}`).digest("hex"); if (!timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(v1, "hex"))) return res.sendStatus(400); const { event, data } = JSON.parse(req.body); // payment.collected · subscription.created / activated / cancelled / expired // data.subscription.subscriber, data.object.slug, data.amount, data.currency res.sendStatus(200); // any 2xx = delivered; else we retry with backoff });