Rollover Documentation
Subscription and billing platform built on x402.
--
# Example
URL: /example

This page exists to show how MDX content is authored in the docs. Use it as a reference when you scaffold new pages.

## Installation

Install the Rollover SDK for your language.

**bun**

```bash
bun add @rolloverdotdev/client
```

**npm**

```bash
npm install @rolloverdotdev/client
```

**pnpm**

```bash
pnpm add @rolloverdotdev/client
```

**yarn**

```bash
yarn add @rolloverdotdev/client
```

## Quick start

Create a plan with the Rollover API.

**TypeScript**

```typescript
import { Rollover } from "@rolloverdotdev/client";

const client = new Rollover("ro_test_...");

const plan = await client.plans.create({
    slug: "pro",
    name: "Pro",
    price_usdc: "29.99",
    billing_period: "monthly",
});
```

**Python**

```python
from rolloverdotdev import Rollover

client = Rollover("ro_test_...")

plan = client.plans.create(
    slug="pro",
    name="Pro",
    price_usdc="29.99",
    billing_period="monthly",
)
```

**Go**

```go
client := rollover.New("ro_test_...")

plan, err := client.Plans.Create(ctx, &rollover.PlanCreateParams{
    Slug:          "pro",
    Name:          "Pro",
    PriceUSDC:     "29.99",
    BillingPeriod: "monthly",
})
```

**Rust**

```rust
use rolloverdotdev::Rollover;

let client = Rollover::new("ro_test_...");

let plan = client.plans().create(
    CreatePlanParams::builder()
        .slug("pro")
        .name("Pro")
        .price_usdc("29.99")
        .billing_period("monthly")
        .build(),
).await?;
```

## Inline elements

Paragraphs are written as plain prose. You can use **bold**, _italic_, and `inline code` inside any paragraph. Links use the standard MDX syntax, like [rollover.dev](https://rollover.dev).

## Code blocks

Fenced code blocks use sugar-high for syntax highlighting.

```ts
import { createPlan } from "@rolloverdotdev/client";

const { data: plan } = await createPlan({
  body: {
    name: "Pro",
    slug: "pro",
    amount: 2999,
    currency: "USDC",
    interval: "month",
  },
});
```

A single line command renders without a file header.

```bash
bun add @rolloverdotdev/client
```

## Headings

Use `##` for top-level section headings on a page. Reserve `#` for the page title, which is rendered automatically from the frontmatter. Subsections use `###` and below.
---

# Introduction
URL: /examples/introduction

Welcome to the Rollover examples. This section collects end to end recipes that show how to wire Rollover into a real application, covering plan switching, usage gating, credit top ups, and subscriber flows. Each example is written for a specific SDK and is intended to be copy ready rather than exhaustive.

Pick the language that matches your stack and walk through the example top to bottom. If a concept is unfamiliar, the Documentation tab has the reference material it builds on.