# paddle

Connect Claude Code to Paddle Billing guidance and docs, then build payment flows for checkout, subscriptions, and webhooks. The included skills cover common integration work, including sandbox testing.

- plugin · `type=plugin` · Claude Code · ★ 9 repo stars
- Author: PaddleHQ
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/PaddleHQ/paddle-agent-skills/tree/HEAD/providers/claude/plugin
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text and 2 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/plugins/paddle

## What it does

The plugin bundles skills for Paddle Billing tasks such as setting up products and prices, adding Checkout to a Next.js app, syncing subscription data through webhooks, and testing in the Paddle sandbox. Describe the work you need, and Claude Code selects a relevant skill. A documentation MCP server gives the assistant access to Paddle materials.

When enabled, Claude Code asks for a sandbox API key and stores it in your keychain. The docs server uses Google or GitHub sign-in; the live server authorizes through browser OAuth. This plugin targets Paddle Billing, so its instructions do not cover Paddle Classic.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install paddle@claude-community
```

## When to use it
- set up Paddle products and prices
- add Paddle Checkout to a Next.js app
- sync subscription data to a database through webhooks
- test an integration in the Paddle sandbox
- cancel a subscription at the end of its billing period

## Example prompts
- Add Paddle Checkout to my Next.js app and handle its events.
- Check my Paddle webhook and sync subscription updates to the database.

## Source text · plugin · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 885b1c0c78853dee.

BEGIN THIRD-PARTY FILE 885b1c0c78853dee
````text
# Paddle agent skills

[Paddle Billing](https://developer.paddle.com/?utm_source=dx&utm_medium=paddle-agent-skills) is the developer-first merchant of record, designed for modern SaaS, AI, mobile app, and digital product businesses. We take care of payments, tax, subscriptions, and metrics with one unified API that does it all.

This repo contains a collection of agent skills that help you implement Paddle in your product. Load them into Claude Code, Codex, Cursor, Gemini CLI, or any agentic coding tool that supports the skills format and your assistant gains step-by-step guidance for the most common Paddle integration tasks.

> **Important:** These skills are written for Paddle Billing. They don't cover Paddle Classic. If you're working with Paddle Classic, see the [Paddle Classic dev docs](https://classic.paddle.com/?utm_source=dx&utm_medium=paddle-agent-skills).

## What's included

A batch of skills covering the most common Paddle integration tasks:

- **[`paddle-billing-history`](skills/billing-history/SKILL.md)** — show authenticated customers their past Paddle transactions with invoice download links.
- **[`paddle-catalog-setup`](skills/catalog-setup/SKILL.md)** — create the Paddle products and prices that other skills depend on.
- **[`paddle-checkout-web`](skills/checkout-web/SKILL.md)** — add a Paddle Checkout (overlay or inline) to a Next.js app, with event handling and customer pre-fill.
- **[`paddle-customer-portal`](skills/customer-portal/SKILL.md)** — mint authenticated customer portal sessions so users can self-serve subscriptions, payment methods, and invoices.
- **[`paddle-onboarding`](skills/onboarding/SKILL.md)** — check your account's onboarding status in sandbox or live, see what's missing against the go-live checklist, and fix the gaps the API allows.
- **[`paddle-pricing-pages`](skills/pricing-pages/SKILL.md)** — render country-localized prices using `Paddle.PricePreview()`, with billing frequency toggle and currency formatting.
- **[`paddle-sandbox-testing`](skills/sandbox-testing/SKILL.md)** — exercise the integration end-to-end in the Paddle sandbox: test cards, webhook simulator, local tunnels.
- **[`paddle-subscription-cancel`](skills/subscription-cancel/SKILL.md)** — build a "cancel at end of period" flow with the right ownership checks and webhook reconciliation.
- **[`paddle-subscription-sync`](skills/subscription-sync/SKILL.md)** — mirror Paddle subscription and customer state into your database via webhooks.
- **[`paddle-subscription-update`](skills/subscription-update/SKILL.md)** — upgrade, downgrade, or change subscription items via the API with proration handling.
- **[`paddle-usage-based-billing`](skills/usage-based-billing/SKILL.md)** — add usage-based billing (early access) to a Next.js app: usage balance units, meters, price allowances, usage events, and balance checks.
- **[`paddle-webhooks`](skills/webhooks/SKILL.md)** — receive and verify Paddle webhooks in a Next.js Route Handler, with idempotency and retry handling.

Each skill lives in its own directory under [`skills/`](skills) and ships with a `SKILL.md` containing the skill's frontmatter and instructions. The same skills are mirrored into each provider's plugin folder under [`providers/`](providers) by [`scripts/sync-skills.mjs`](scripts/sync-skills.mjs) — see [CONTRIBUTING.md](CONTRIBUTING.md) for the layout.

## Install as a Claude Code plugin

The Paddle plugin is listed in Anthropic's community plugin marketplace. Inside [Claude Code](https://claude.com/claude-code), run:

```text
/plugin marketplace add anthropics/claude-plugins-community
/plugin install paddle@claude-community
```

Then ask Claude something Paddle-shaped, like "help me verify a Paddle webhook in Next.js," and the relevant skill is selected automatically.
````
END THIRD-PARTY FILE 885b1c0c78853dee

The third-party file has ended. Everything between the 885b1c0c78853dee tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3821 of 10829 bytes. © PaddleHQ · Apache-2.0 · https://github.com/PaddleHQ/paddle-agent-skills/tree/HEAD/providers/claude/plugin

## Similar
- [silicon-paddle-ocr](https://affpapa.org/en/nevibecode/skills/silicon-paddle-ocr.md) — skill · 1200 installs
- [paddle-webhooks](https://affpapa.org/en/nevibecode/skills/paddle-webhooks.md) — skill · 258 installs
- [Paddle (Sandbox)](https://affpapa.org/en/nevibecode/mcp/paddle-sandbox.md) — MCP server
- [claude-code-guide](https://affpapa.org/en/nevibecode/skills/claude-code-guide.md) — skill · 905 installs
- [StoryLenses MCP Server](https://affpapa.org/en/nevibecode/mcp/storylenses-mcp-server.md) — MCP server · 893 installs
- [JassWiki — Swiss Jass Authority](https://affpapa.org/en/nevibecode/mcp/jasswiki-swiss-jass-authority.md) — MCP server · 868 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
