Paddle Webhooks

Receive and verify Paddle webhooks in a Next.js Route Handler — signature verification, idempotency, retry semantics, and local testing.

9 stars 2 forksTesting & QA Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add PaddleHQ/paddle-agent-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add PaddleHQ/paddle-agent-skills --skill paddle-webhooks
Manual install
git clone --depth 1 https://github.com/PaddleHQ/paddle-agent-skills.git /tmp/paddle-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/paddle-agent-skills/providers/claude/plugin/skills/webhooks ~/.claude/skills/paddle-webhooks

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Receive Paddle webhooks securely in Next.js

## When to use this skill

Use this skill when building the server-side endpoint that receives Paddle webhook events (subscription changes, transactions, customer updates, payouts, etc.). It covers creating the notification destination in Paddle, writing a Next.js Route Handler that verifies signatures and processes events, handling retries and idempotency, and local testing.

This skill is the foundation for almost every server-side Paddle integration. Pair with:

- `subscription-sync` — turn webhook events into rows in your database.
- `sandbox-testing` — drive your endpoint with the webhook simulator.
- `checkout-web` — the client-side counterpart that triggers the events you'll receive here.

## The delivery contract

Every design choice in this skill follows from these facts about how Paddle delivers webhooks. Read this section first; everything else is mechanics.

- **Only `2xx` within 5 seconds is "delivered."** Any other response — `400`, `401`, `500`, `503`, a redirect, a connection timeout — is treated as a failed delivery and gets retried. There is no status code that means "stop retrying" on the integrator side. Paddle retries any non-2xx response.
Read the full skill on GitHub

Details

Skill name
paddle-webhooks
Path
providers/claude/plugin/skills/webhooks/SKILL.md
License
Apache-2.0
Repo updated
18 November 2026

FAQ

What does the Paddle Webhooks skill do?

Receive and verify Paddle webhooks in a Next.js Route Handler — signature verification, idempotency, retry semantics, and local testing.

How do I install the Paddle Webhooks skill?

Claude Code plugin: /plugin marketplace add PaddleHQ/paddle-agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Paddle Webhooks popular?

It lives in PaddleHQ/paddle-agent-skills, which has 9 GitHub stars and 2 forks.

Related skills

Paddle Billing History

9

PaddleHQ/paddle-agent-skills

Render the authenticated user's billing history in Next.js — listing transactions via the Paddle Node SDK, the mandatory customer-id filter, pagination via `.next()`/`.hasMore`, status filtering, on-demand invoice PDF links, and formatting raw transaction totals (lowest-unit conversion + Intl.NumberFormat, with the zero-decimal currency special case for JPY/KRW/VND/CLP).

Documents & Office Files

Paddle Catalog Setup

9

PaddleHQ/paddle-agent-skills

Create the Paddle products and prices that other Paddle skills depend on — try MCP tools first, then the Paddle CLI, fall back to a Node SDK seed script, or dictate dashboard steps as a last resort.

Software Development

Paddle Checkout Web

9

PaddleHQ/paddle-agent-skills

Add a Paddle Checkout to a Next.js web app — overlay or inline, with event handling, customer pre-fill, and dynamic line item updates.

Frontend & Design

Spring Boot Testing

5

senoritadeveloper01/claude-skills

Use this skill when writing or improving tests in a Spring Boot project, including unit tests, integration tests, and test structure.

Testing & QA

Paddle Sandbox Testing

9

PaddleHQ/paddle-agent-skills

Test a Paddle integration end-to-end using the sandbox environment, test cards, the webhook simulator, and local tunnels — without taking real money.

Testing & QA

Wp E2E Testing

9

morrealev/wordpress-manager

Use when setting up, writing, or debugging WordPress tests: E2E with Playwright, unit tests with PHPUnit, JavaScript tests with Jest, visual regression, test data generation, wp-env test environment, and CI pipeline integration.

Testing & QA

Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.