A professional-grade framework for building secure, compliant payment integrations and automated subscription management systems.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install billing
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 billing 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 Billing?
The Billing module within Openclaw Skills is designed to help developers architect robust financial systems, covering everything from initial payment processing to complex revenue operations. It provides a technical blueprint for integrating providers like Stripe and Paddle while ensuring strict adherence to security standards such as PCI-DSS compliance and webhook signature verification.
By leveraging this skill, teams can implement sophisticated subscription state machines, handle multi-currency transactions using integer-based math, and automate invoicing with built-in tax compliance logic. This component of Openclaw Skills ensures that financial data remains consistent and secure, even when dealing with asynchronous webhook events or complex proration scenarios.
Billing Use Cases
- Building secure SaaS subscription models with trial periods and automated renewal logic.
- Implementing international marketplace payment splits and multi-currency support.
- Automating global tax compliance for VAT, MOSS, and US Sales Tax jurisdictions.
- Developing idempotent webhook handlers to manage payment events and subscription state changes safely.
- Managing revenue recognition patterns for ASC 606/IFRS 15 accounting standards.
How Billing Works
- Initialize payment integrations using the smallest currency units (integers) to ensure mathematical precision and prevent floating-point errors.
- Configure secure webhook endpoints with mandatory signature verification to handle asynchronous events like invoice.paid or customer.subscription.deleted.
- Map subscription states (trialing, active, past_due, canceled) to internal application access controls using a robust state machine.
- Apply explicit proration and tax logic to handle mid-cycle plan changes and international compliance requirements.
- Implement idempotent database transactions to reconcile payment provider data with local records, mitigating race conditions.
Billing Setup
To integrate the Billing logic into your project via Openclaw Skills, ensure your environment is configured for your chosen payment provider:
# Example: Setting up a Stripe-based environment
# 1. Install the provider SDK
npm install stripe
# 2. Configure necessary environment variables
export STRIPE_SECRET_KEY="your_secret_key"
export STRIPE_WEBHOOK_SECRET="your_webhook_signing_secret"
# 3. Initialize your local state machine to match the Billing skill schema
Billing Data Schema & Taxonomy
The Billing skill organizes financial data to ensure auditability and precision. Key data structures include:
| Object | Organization Method | Primary Metadata |
|---|---|---|
| Monetary Amounts | Integer-based (Cents) | amount_cents, currency_code |
| Subscription State | Status-based Enum | status, current_period_end, cancel_at_period_end |
| Webhook Events | Idempotency Mapping | event_id, processed_at, signature_verified |
| PCI Tokens | External Reference Only | cus_id, pm_id (No raw card data) |
| Tax Records | Jurisdiction Mapping | vat_id, reverse_charge_status, tax_rate |
Billing Advanced Features
- Advanced webhook idempotency logic to handle out-of-order event delivery.
- Built-in support for usage-based billing and complex enterprise pricing tiers.
- Automated VIES VAT number verification for B2B reverse-charge compliance.
- Integrated revenue recognition patterns for handling deferred revenue on annual plans.
- Automated chargeback management and proactive evidence submission workflows.
SKILL.md
Loading
Related Openclaw Skills
Bible
A high-precision theological study skill for AI agents focusing on citation accuracy, original language analysis, and systematic interpretation methodology.
Beszel
A specialized tool for deploying, securing, and optimizing Beszel infrastructure monitoring using Docker agents and automated operational playbooks.
Berlin City Guide
A sophisticated intelligence module providing localized data for visitors, expats, and entrepreneurs in Berlin.
Bengali Language Optimization
A specialized skill designed to make AI-generated Bengali sound human, expressive, and culturally authentic rather than robotic or overly formal.
Binance API
Securely manage Binance Spot trading, market data streams, and API signatures through automated terminal-based workflows.
Bioinformatics
A specialized skill for executing genomic analysis pipelines, sequence alignment, and variant calling using industry-standard command-line tools.
Featured*
