Feeling a bit stuck? No worries—everyone does sometimes. This is your go-to spot for quick solutions and pro tips. We’ve polled our users, chatted with our team, and gathered all the essential know-how to make your Unibee journey smooth and successful.
Contents
Product Overview
What is UniBee and who is it for?
UniBee is an open-source billing system for SaaS businesses, designed as a user-friendly, cost-effective alternative to closed-source solutions. The docs guide you from setup to a fully customized billing stack.
Products & Plans
What plan types can I create, and where?
In Admin → Product & Plan, you can create Main plans, Recurring add-ons, and One-time payments. You can set an External Plan ID, currency, price, and billing interval, then Activate/Publish the plan.
Assigning Subscriptions
Can I assign a plan to a specific user (with or without payment)?
Yes. Go to the user’s Subscription tab → Assign Subscription. You can pick plan type, configure account details (personal/business + VAT), choose payment method, and optionally untick “Require payment” for internal/testing.
Docs: Assign a subscription plan to a user – UniBee Documentation
Managing User Profiles
Can I view/edit billing info (address, VAT number, payment method) for a user?
Yes. From User List → User detail, you can view and update name, email, billing address, VAT number, payment method, and more; then Save to apply changes.
Usage-Based Billing (Billable Metrics)
Does UniBee support usage/metric-based billing?
Yes. Billable Metrics support multiple aggregation types (e.g., Count, Count Unique, Latest, Max, Sum) and provide analytics/reporting for pricing and usage insights.
Discounts & Promotions
How do I create and manage discount codes?
In Discount Code you can Create, Edit, Copy, Activate/Archive codes; choose fixed/percentage, one-time or recurring (with cycle limits), set date range and applicable plans.
Docs: Create, edit, copy and archive – UniBee Documentation
Can I see usage details for a discount code?
Yes. Use the usage view to understand where/how a code is applied.
Docs: View the usage of a discount code – UniBee Documentation
Can I search/filter/export discount codes?
Yes. You can fuzzy-search by Code/Code Name, filter by status/type, and export either usage details or a code list.
Tax & VAT
How do I collect taxes (e.g., VAT) automatically?
Integrate VATSense from Admin Portal → Settings → Integrates by adding your API key. Standard taxes are computed on initial and recurring charges, and country tax rates are updated weekly.
Testing & Sandbox
How do I test payments and subscriptions end-to-end?
Use the Testing Cards (Sandbox) guide. It links official test resources for Stripe/PayPal/Payssion/Antom (Alipay), so you can simulate success/failure flows before going live.
API & Authentication
Do you provide an API and how do I authenticate?
Yes. The API uses Bearer tokens in the Authorization header. You can obtain tokens via member authentication endpoints and then access product, plan, subscription, invoice, merchant, etc. resources.
Docs (Bearer header shown): Password Login – UniBee Documentation
Docs (Bearer header details section): Admin Member Clear Member 2FA Key With ResumeCode – UniBee Documentation
API Examples / Key Endpoints
Where can I see a concrete product API example?
The Product Detail page shows product-level endpoints and is a good entry point to explore related resources.
Docs: Product Detail – UniBee Documentation
How do I check my merchant license/profile via API?
Use the Merchant → Get License endpoint to retrieve license/type information for your workspace.
Typical Onboarding Flow
What’s a recommended setup sequence?
1) Read Introduction → 2) Configure Products & Plans → 3) Set up Taxes (VATSense) if needed → 4) Run Sandbox tests with gateway test resources → 5) Go live.
Intro: Introduction – UniBee Documentation
Plans: Subscription Plan – UniBee Documentation
Getting Help
Where do I get help or discuss commercial support?
Start with the docs above for the relevant module. For API issues, include request/response samples and error messages. For commercial support, contact UniBee via the main site.
Docs: Introduction – UniBee Documentation
UniBee Support Email: help@unibee.dev