Paddle Webhooks
Receive and verify Paddle webhooks in a Next.js Route Handler — signature verification, idempotency, retry semantics, and local testing.
Install
/plugin marketplace add PaddleHQ/paddle-agent-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add PaddleHQ/paddle-agent-skills --skill paddle-webhooksgit 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-webhooksPersonal 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.
Details
- Skill name
paddle-webhooks- Repository
- PaddleHQ/paddle-agent-skills
- 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
9PaddleHQ/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).
Paddle Catalog Setup
9PaddleHQ/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.
Paddle Checkout Web
9PaddleHQ/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.
Spring Boot Testing
5senoritadeveloper01/claude-skills
Use this skill when writing or improving tests in a Spring Boot project, including unit tests, integration tests, and test structure.
Paddle Sandbox Testing
9PaddleHQ/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.
Wp E2E Testing
9morrealev/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.
Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.