billing-automation

What This Skill Does

The billing-automation skill is a robust toolkit designed to handle the complex lifecycle of SaaS recurring revenue. It provides an abstraction layer for managing subscription states, calculating prorated plan adjustments, and executing dunning workflows when payments fail. By integrating this skill, your OpenClaw agent gains the ability to calculate taxes (VAT/GST) based on customer location, manage billing cycle anchors, and automate the transition between trial, active, and past-due statuses. It serves as the primary engine for any application requiring sophisticated revenue management.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/anton-abyzov/sw-billing-automation Ensure your development environment is authorized to pull from the openclaw/skills repository before running the installation command.

Use Cases

• Automated Invoicing: Trigger invoice generation the moment a subscription cycle renews.
• SaaS Plan Management: Handle mid-cycle upgrades or downgrades by calculating the exact monetary proration for the remaining balance of the period.
• Dunning Management: Configure automated retry schedules for failed credit card charges to recover lost revenue without manual intervention.
• Usage-Based Billing: Calculate billing totals based on external usage data, such as API calls or seat counts, and append these to the recurring monthly invoice.
• Tax Compliance: Automatically calculate and apply necessary VAT or GST rates based on the customer’s configured tax profile.

Example Prompts

1. "Calculate the proration credit for a customer upgrading from the Basic plan ($20) to the Pro plan ($50) with 10 days remaining in their monthly cycle."
2. "Set up a dunning workflow for user 'cus_999' that retries failed payments every 3 days, three times, before changing the status to 'past_due'."
3. "Generate an invoice for subscription 'sub_abc' and include an additional usage fee of $15.50 for data storage overages."

Tips & Limitations

• Data Integrity: Always ensure that customer billing anchors are correctly set during subscription creation to avoid off-cycle charges.
• State Transitions: Do not manually update the 'status' variable; always use the built-in methods provided by the BillingEngine to ensure proper state management and logging.
• Limitations: This skill is focused on the logic of billing. You must integrate a separate payment gateway (e.g., Stripe, Braintree) to execute the actual financial transactions against credit card providers.