Integrate Paddle payments with subscriptions, webhooks, checkout, and tax compliance.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install paddle
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install paddle using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Paddle?
The Paddle skill is a specialized technical resource designed to streamline the integration of global payment processing for AI coding agents. As a key component of the Openclaw Skills library, it offers a standardized framework for handling complex billing logic, including subscription state transitions, proration, and dunning management. By using this skill, developers ensure that their AI agents follow best practices such as sandbox-first development and strict webhook signature verification, minimizing the risk of security vulnerabilities and payment failures while maintaining PCI compliance through Paddle's hosted architecture.
Paddle Use Cases
- Automating SaaS subscription management and recurring billing cycles.
- Implementing secure webhook endpoints to handle real-time payment events.
- Setting up global checkout experiences with automated tax compliance.
- Mapping Paddle customer and transaction IDs to internal database records for seamless user management.
How Paddle Works
- The AI agent initializes the local environment within the
~/paddle/directory using provided memory templates. - API keys and environment variables are configured, prioritizing the sandbox endpoint for safe initial development.
- Checkout flows are generated and integrated into the application using specific price and product IDs.
- Incoming webhooks are processed through a mandatory verification layer that validates signatures against the Paddle dashboard secret.
- The agent monitors and acts upon subscription states such as active, trialing, past_due, and canceled to manage user access levels.
Paddle Setup
To install this skill and add it to your agent's toolkit, use the following command:
clawhub install paddle
Following installation, update your credentials in ~/paddle/memory.md and follow the integration guidelines located in setup.md.
Paddle Data Schema & Taxonomy
The skill maintains data in a dedicated directory structure to ensure context persistence and security:
| File | Description |
|---|---|
memory.md |
Stores API keys, environment settings (Sandbox vs Production), and product/price IDs. |
webhooks.md |
Documents webhook endpoints, secrets, and specific event handling logic. |
Data is categorized using standard Paddle identifiers:
customer_id(ctm_xxx): Unique identifier per customer.subscription_id(sub_xxx): Unique identifier per subscription.transaction_id(txn_xxx): Unique identifier per payment event.price_id(pri_xxx): Specific pricing configuration identifier.
Paddle Advanced Features
- Automated dunning management through integrated Paddle Retain logic for failed payments.
- Granular subscription lifecycle tracking including trial and grace period handling.
- Built-in support for upgrade and downgrade proration logic.
- Multi-environment switching to ensure safe transitions from sandbox testing to production deployment.
- Native integration with related Openclaw Skills such as billing and payments for holistic financial management.
SKILL.md
Loading
Related Openclaw Skills
Outreach
A professional framework for planning, personalizing, and tracking high-impact outreach campaigns across multiple channels.
Outfits
A personal style assistant that manages your wardrobe inventory and plans outfits for any occasion.
Organize
A proactive organization tool that learns user preferences to structure files and folders during the active workflow.
Oracle DB
An expert coding skill for generating optimized Oracle SQL and PL/SQL blocks with enterprise-grade performance patterns.
Pandas
A high-performance skill for analyzing, transforming, and cleaning Python DataFrames using efficient vectorized operations and professional best practices.
Parenting AI Assistant
A sophisticated AI agent skill designed to provide evidence-based, age-appropriate parenting guidance while avoiding common advice pitfalls.
Featured*
