Integrate with Astro
Add billing and payments to your Astro application.
Use this pre-built prompt to integrate Commet faster with AI assistants.
Astro requires an SSR adapter for API routes. Set output: 'server' or output: 'hybrid' in your astro.config.mjs.
Install
pnpm add @commet/nodenpm install @commet/nodeyarn add @commet/nodebun add @commet/nodeConfigure
COMMET_API_KEY=ck_sandbox_xxximport { Commet } from '@commet/node'
export const commet = new Commet({
apiKey: import.meta.env.COMMET_API_KEY,
environment: 'sandbox',
})Subscribe
customers.create is idempotent — if a customer with the same id already exists, it returns the existing record.
import type { APIRoute } from 'astro'
import { commet } from '../../../lib/commet'
export const POST: APIRoute = async ({ request }) => {
const { customerId, email } = await request.json()
await commet.customers.create({ email, id: customerId })
const subscription = await commet.subscriptions.create({
customerId,
planCode: 'pro',
})
return Response.json({ checkoutUrl: subscription.data.checkoutUrl })
}Check Access
import type { APIRoute } from 'astro'
import { commet } from '../../../../lib/commet'
export const GET: APIRoute = async ({ params }) => {
const { data: subscription } = await commet.subscriptions.get(params.customerId!)
const { data: feature } = await commet.features.check({
code: 'api_calls',
customerId: params.customerId!,
})
return Response.json({
status: subscription.status,
allowed: feature.allowed,
})
}Track Usage
import type { APIRoute } from 'astro'
import { commet } from '../../../lib/commet'
export const POST: APIRoute = async ({ request }) => {
const { customerId } = await request.json()
await commet.usage.track({
customerId,
feature: 'api_calls',
value: 1,
})
return Response.json({ tracked: true })
}Usage is aggregated and billed at end of period.
Customer Portal
import type { APIRoute } from 'astro'
import { commet } from '../../../lib/commet'
export const GET: APIRoute = async ({ redirect }) => {
const customerId = 'user_123'
const { data } = await commet.portal.getUrl({ customerId })
return redirect(data.portalUrl)
}Related
How is this guide?