Selling your app
Charge for a store app — payouts through Stripe, monthly, yearly or one-time prices with an optional trial, what Chataway keeps, and how your server verifies the license header on every call.
Any store app can be paid — a cloud app or a verified local app. Chataway is the seller: buyers pay on chataway.co through Stripe Checkout, we collect and remit VAT, and you are paid out every month through your own Stripe account.
#1. Set up payouts
Developer area → your publisher → Set up payouts. Choose your country and whether you sell as an individual or a company; Stripe then asks for your identity and bank details on its own pages (a Stripe Express account — Chataway never sees your bank details). Individuals are welcome: Stripe verifies you, so you don't need a verified domain to sell.
When Stripe has what it needs, the publisher shows Payouts on. Payouts dashboard opens your Stripe Express dashboard (balance, payouts, tax forms, bank account).
- Payouts are monthly (on the 1st) and hold each sale for 14 days, so refunds and disputes in the first weeks can still be settled from your balance.
- Only owners of a publisher can set up payouts and prices; members see sales.
#2. Set prices
Developer area → the app → Pricing. Offer any of:
| Option | Minimum |
|---|---|
| Monthly subscription | €3.00 |
| Yearly subscription | €3.00 |
| One-time purchase | €5.00 |
Prices are in euros and include VAT — the buyer pays exactly the listed price wherever they are. An optional free trial (up to 90 days) applies to the subscriptions; each buyer gets one trial per app.
Prices live on the store listing, not in your manifest: changing them is not a new version and needs no review. A changed price applies to new buyers; existing subscribers keep the price they signed up at. Remove every price and the app is free again.
#Money
For each sale Chataway keeps a 15% commission (some publishers have an agreed rate — the Pricing card shows yours) and the VAT of the buyer's country. You receive the rest:
your share = (price − VAT) × (1 − commission)A €9.99 monthly price bought in Germany (19% VAT → €1.60) pays you (9.99 − 1.60) × 0.85 = €7.13. Stripe's processing fees are on Chataway.
Refunds. A refunded payment takes your share of it back from your balance and gives back our commission on it; a full refund ends the buyer's access (and cancels a subscription). Disputes (chargebacks) work the same way and suspend access. The Developer area lists every sale, reversal and payout.
EU withdrawal. Buyers agree at checkout that the app is delivered right away, which ends their 14-day right of withdrawal. Refund requests are handled by Chataway support.
#How buyers get access
The store shows your prices. A buyer installs the app and taps Buy — the payment happens in their browser on chataway.co (never inside the iPhone app; on iPhone the app says to buy on the web or on a computer). As soon as Stripe confirms the payment, Chataway turns the app on.
Until then — and when a subscription ends or is refunded — the app stays installed but paused: its runtime doesn't start, so its tools are not offered to the agent and Chataway doesn't call a cloud app's server. Your server should still check the license itself (below): that is the check that can't be bypassed on someone else's computer.
#Verify the license on your server
Every call Chataway makes to a paid cloud app's MCP server — initialize, tools/list, every tools/call — carries a signed license:
X-Chataway-License: eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCIsImtpZCI6IuKApiJ9.eyJ…It is a JWT signed with Ed25519 (alg: EdDSA) by the Chataway store key, valid for 24 hours and refreshed by the app well before it expires. Claims:
| Claim | |
|---|---|
iss | https://chataway.co |
aud, appId | your app id — refuse tokens for any other |
sub | the buyer, pseudonymous: stable for your app, different for every other app, never their account id or email |
plan | monthly, yearly or one_time |
kind | subscription, trial or one_time |
status | active, trialing or past_due (a renewal failed; Stripe is retrying — still paid up) |
periodEnd | end of the paid or trial period (Unix seconds), null for one-time |
iat, nbf, exp, jti | issued, not before, expiry, token id |
The public key is published as a JWKS at https://chataway.co/.well-known/chataway-license-keys.json (also GET /api/app-billing/license-keys). Cache it for a few minutes and match the token's kid.
With jose:
import { createRemoteJWKSet, jwtVerify } from 'jose';
const JWKS = createRemoteJWKSet(new URL('https://chataway.co/.well-known/chataway-license-keys.json'));
export async function license(req: Request) {
const token = req.headers.get('x-chataway-license');
if (!token) return null; // free use, or refuse
const { payload } = await jwtVerify(token, JWKS, {
issuer: 'https://chataway.co',
audience: 'com.example.acme-assets', // your app id
algorithms: ['EdDSA'],
});
return payload; // { sub, plan, status, … }
}With Node's crypto only:
import crypto from 'node:crypto';
const jwks = await (await fetch('https://chataway.co/.well-known/chataway-license-keys.json')).json();
function verify(token: string, appId: string) {
const [h, p, s] = token.split('.');
const header = JSON.parse(Buffer.from(h, 'base64url').toString());
const jwk = jwks.keys.find((k: any) => k.kid === header.kid);
if (!jwk || header.alg !== 'EdDSA') return null;
const key = crypto.createPublicKey({ key: { kty: 'OKP', crv: 'Ed25519', x: jwk.x }, format: 'jwk' });
if (!crypto.verify(null, Buffer.from(`${h}.${p}`), key, Buffer.from(s, 'base64url'))) return null;
const claims = JSON.parse(Buffer.from(p, 'base64url').toString());
const now = Date.now() / 1000;
if (claims.iss !== 'https://chataway.co' || claims.aud !== appId || claims.exp < now - 60) return null;
return claims;
}A request without the header, or with one that doesn't verify, comes from someone who hasn't paid (or from an old Chataway). Answer the tool call with a short error such as "Your Acme subscription has ended — renew it from the app's page in Chataway."
Key the buyer's data on sub. It doesn't tell you who the buyer is and can't link them across apps; it stays the same for as long as they own your app.
#FAQ
Can I offer a free tier? Yes — keep the app free and gate premium tools on your server by the license header (no header = free tier). Or price it and use the trial.
Can I change a buyer's plan? Buyers manage, switch and cancel subscriptions themselves (the app's page → Manage, Stripe's customer portal).
Which countries can receive payouts? Most of Europe, the US, the UK, Canada, Australia, New Zealand, Japan and Singapore — the payouts form lists them.