Your first Solana subscriber in four steps

1. Publish a plan

   In the dashboard, open Plans and create one: a name, a price, a token, a period, and the wallet that receives the money. Your wallet signs its creation. An end date is optional.

   Mesub derives the plan's slug from its name: a plan named Pro gets pro. The slug is how your code names the plan everywhere below. You can read it in the plan's Implement tab, where the code on this page is already filled in with it.
2. Give your server the API key

   In the dashboard, open Developers and create the project's API key. It starts with SUB_ and is shown once: more on the key. Put it in your server's environment:

   1MESUB_API_KEY=SUB_...

   Then install the SDK with your package manager:

   1npm install @mesub/node

   pnpm add @mesub/node, yarn add @mesub/node and bun add @mesub/node work the same. It goes in dependencies: your server needs it in production.
3. Mount the routes and gate a route

   Two things on your server. The routes are what the widget calls to subscribe and manage. The gate is the question you ask before serving anything paid. Both need to know who is asking, and that comes from your own login.

   ExpressNext.jsNestJS

   1234567891011121314151617181920212223import { Mesub } from '@mesub/node';
   import { mesubRoutes } from '@mesub/node/express';
   
   const mesub = new Mesub(); // reads MESUB_API_KEY
   
   // What the widget calls. Mount it after your own login.
   app.use(
       '/api/mesub',
       yourLogin,
       mesubRoutes({
           customer: (req) =>
               req.user ? { external_id: req.user.id } : null,
       }),
   );
   
   // A paid route.
   app.get('/api/analytics', yourLogin, async (req, res) => {
       if (!(await mesub.hasAccess({ external_id: req.user.id }, 'pro'))) {
           res.status(402).json({ error: 'The Pro plan is needed.' });
           return;
       }
       res.json(buildAnalytics(req.user));
   });

   customer must come from a session you verified, never from what the browser sends. When it returns null, the routes answer 401. The Next.js and NestJS examples use the SDK's guards, which answer 401 and 402 themselves; Express has one too, requirePlan.
4. Put the button on a page

   1npm install @mesub/react

   It needs react and react-dom 18 or later. @mesub/react 0.1.x works with the routes of @mesub/node 0.1.x: keep the two at the same minor.

   Wrap your app once, pointing at where you mounted the routes:

   123456import { MesubProvider } from '@mesub/react';
   import '@mesub/react/styles.css';
   
   export function App({ children }) {
       return <MesubProvider endpoint="/api/mesub">{children}</MesubProvider>;
   }

   The wallet signs for devnet by default. For plans on mainnet, add chain="solana:mainnet".

   Then place the button, with the plan's slug:

   123import { SubscribeButton } from '@mesub/react';
   
   <SubscribeButton plan="pro">Subscribe to Pro</SubscribeButton>;

Try it