> ## Documentation Index
> Fetch the complete documentation index at: https://www.carstoragesoftware.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing

> How products, invoices, recurring plans, payment methods, fees, taxes, quotes, refunds, and accounting sync work together.

Billing lives under **Payments** in the sidebar and runs on your facility's own Stripe account. You set prices once as **products**, then charge customers in two ways: a **one-off invoice** for a single charge, or a **recurring plan** that bills automatically every period. Every invoice and plan belongs to a customer.

## Key terms

### What you sell

* **Product** — Something you charge for, such as "Indoor storage" or "Full detail". Its payment type is **Recurring** (storage plans that bill on a cadence) or **One-time** (services, parts, marketplace items). Managed in **Products & services**.
* **Variant** — One price for a product. A product can have several, for example $500 monthly and $1,350 quarterly. Each variant has its own billing frequency, tax rate, optional automatic rate increase, optional commitment term, and optional fee handling.

### How you charge

* **Invoice** — A bill for one-off charges, created with **New invoice** in **Invoices & quotes**. Statuses: Draft, Open, Paid, Void, Uncollectible. Reports also flag Overdue invoices.
* **Recurring plan** — A storage plan that invoices the customer every period (a Stripe subscription). The sidebar calls the list **Recurring invoices**, and you create one with **Add recurring**. Statuses include Active, Scheduled (starts later), Paused, Past Due, Cancels on a date, and Cancelled.
* **Billing date** — The day a plan bills each period: the 1st, the same day it started, or a day you pick. The first invoice can be prorated or charge the full period.
* **Collection mode** — **Charge payment method** charges a saved card or bank account automatically. **Send invoice** emails the customer to choose how to pay.
* **Add to next bill** — A one-off charge (a detail, a battery replacement) held until the customer's next recurring invoice, so they get one bill. Event types can add charges this way automatically.
* **Quote** — Pricing you send for approval before billing. The customer accepts it online, and it becomes the invoice they pay. A quote can also include a recurring schedule. Quotes are turned on in **Settings → Billing → Quotes & estimates**.

### How customers pay

| Method | What it is |
| - | - |
| Credit card | Card paid online or saved for automatic charges |
| Bank account | ACH debit from the customer's bank, paid online or saved for automatic charges |
| Manual ACH | The customer sends a bank transfer from their own bank app to a routing and account number unique to them. The invoice is marked paid when the money arrives. Turn it on in **Settings → Billing → Manual ACH**. |
| Tap to Pay | In-person card payment on a staff iPhone (Car Storage Software Utilities app) or a card reader |
| Cash / check | Recorded by staff with **Mark as paid (cash/check)** |
| Balance | Account credit applied with **Pay from balance** |

### Fees, taxes, and corrections

* **Processing fees** — Card and bank processing costs, plus a platform service fee. In **Settings → Billing → Processing fees** you choose **Facility pays**, **Customer pays**, or **Split**. When the customer pays, the fee is added as its own line (for example, "Card processing fee"). Cash, check, Tap to Pay, and balance payments don't get a fee line.
* **Fee overrides** — Fees follow the most specific setting: a single invoice or plan, then the customer's **Fee Settings**, then the product variant, then the team default.
* **Tax rate** — A percentage you create (sales tax, VAT, GST, or exempt), set as a default on the team, a customer, a variant, a plan, or a single invoice line. Rates can be tax-inclusive, and you choose whether processing fees are taxed.
* **Refund** — Returns all or part of a payment to the customer's card or bank.
* **Credit note** — Reduces an open invoice without refunding money.
* **Account credit** — Adds money to the customer's balance, which applies to their next invoice automatically.

### Reporting and accounting

* **Cash vs Accrual** — On the **Recurring revenue** report only. Cash counts each charge in full on its billing date. Accrual spreads it over the days it covers, so a yearly plan shows about one-twelfth each month.
* **Accounting sync** — Customers, products, invoices, payments, refunds, credits, payouts, and Stripe fees are sent to **QuickBooks Online** or **Xero** (one at a time). It's one way: changes in your books don't come back. **QuickBooks Desktop** gets a file export instead of a live sync.

## How billing connects to everything else

| Linked record | Relationship |
| - | - |
| Customer | Owns invoices, plans, saved payment methods, balance, and fee and tax settings. |
| Car | Can be linked to the plan (and plan line) that pays for its storage. |
| Events | Event types can add a charge to the next bill, and drop-offs and pick-ups can start, change, or end a plan. |
| Contracts | A contract can be tied to a product and price. |
| Portal | Customers see invoices, plans, and quotes, pay online, and manage saved payment methods. |

## Common setups

* **Monthly storage** — A Recurring product per storage tier, one plan per customer billed on the 1st, charged to a saved card or bank account.
* **Services on top** — Details and battery care as One-time products added to the next bill.
* **Annual prepay** — A yearly variant with Accrual reporting to see revenue month by month.
* **Pass fees through** — **Customer pays** as the team default, waived for a few long-time customers in their Fee Settings.

## Related how-tos

* [Create an invoice](https://www.carstoragesoftware.com/docs/payments/create-an-invoice.md)
* [Manage recurring billing](https://www.carstoragesoftware.com/docs/payments/set-up-recurring-billing.md)
* [Manage products and services](https://www.carstoragesoftware.com/docs/payments/manage-products-and-services.md)
* [Accept manual ACH bank transfers](https://www.carstoragesoftware.com/docs/payments/accept-manual-ach-bank-transfers.md)
* [Connect accounting integrations](https://www.carstoragesoftware.com/docs/settings/connect-accounting-integrations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.