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

# Billing & Usage

> Monitor your billing and usage metrics.

## Overview

Monitoring your billing and usage is essential for managing finances and ensuring accurate client invoicing.

***

## Table of Contents

1. [How Billing Works](#how-billing-works)
2. [Setting Up Your Stripe Account](#setting-up-your-stripe-account)
3. [Pricing Your Services](#pricing-your-services)
4. [Managing Client Balances](#managing-client-balances)
5. [Understanding Profitability](#understanding-profitability)
6. [Billing Best Practices](#billing-best-practices)
7. [Frequently Asked Questions](#faqs)

***

## How Billing Works

### The Big Picture

As a Vapify agency, you have complete control over how you charge your clients:

* **You set the prices** - Choose your markup and billing model
* **Your clients pay you directly** - Through your branded Stripe checkout
* **We handle the infrastructure** - Voice AI processing and call management
* **You keep the profit** - The difference between what you charge and provider costs

```
Your Client → Pays You (via Stripe) → You manage their account
                ↓
        Vapify tracks usage & handles billing
                ↓
        Voice Provider (Vapi/Retell) processes calls
```

### What Gets Billed

Every voice call your clients make or receive has a cost:

* **Provider Cost:** What the voice AI service (Vapi, Retell, Eleven Labs) charges
* **Your Markup:** What you add on top of the provider cost to make profit
* **Total Price:** What your client pays

**Example:**

* Provider charges: \$0.30 per minute
* You charge your client: \$0.50 per minute
* Your profit: \$0.20 per minute (40% margin)

***

## Setting Up Your Stripe Account

Before you can charge clients, you need to connect your Stripe account. This lets clients pay you directly while seeing your branding (not Vapify's).

### Step 1: Connect Stripe

1. Go to Billing & usage Settings
2. On the Connect Stripe Account Setup card, Click Get Started
3. You'll be redirected to Stripe to create or connect your account

<img src="https://mintcdn.com/vapifybykanzucode/A3O19gLqD2_WDy2-/images/vapify-stripe-connect.png?fit=max&auto=format&n=A3O19gLqD2_WDy2-&q=85&s=322baa261bde6cd0bf9a9eb11945000b" alt="Billing & Usage" width="1366" height="623" data-path="images/vapify-stripe-connect.png" />

### Step 2: Complete Stripe Onboarding

Stripe will guide you through providing:

* Business information
* Banking details (for payouts)
* Identity verification

This typically takes 5-10 minutes.

### Step 3: Verify Connection

Once connected, you'll see:

* ✅ Connected Account ID
* Your account status
* Link to Stripe Dashboard

<img src="https://mintcdn.com/vapifybykanzucode/A3O19gLqD2_WDy2-/images/stripe-connected.png?fit=max&auto=format&n=A3O19gLqD2_WDy2-&q=85&s=96dbd34148a7f36598590a74f37340a9" alt="Billing & Usage" width="1366" height="635" data-path="images/stripe-connected.png" />

**Important:** Your clients' payments go directly to your Stripe account. Vapify never holds your funds.

### Managing Your Stripe Account

**View your Stripe Dashboard:**

1. Go to Billing & Usage
2. Click Stripe Dashboard
3. See payments, payouts, and customer data

**Disconnect Stripe (if needed):**

1. Go to Agency Settings → Billing
2. Click Disconnect Stripe
3. Confirm disconnection

⚠️ **Warning:** Disconnecting Stripe will prevent new client payments and subscriptions.

***

## Pricing Your Services

You have two main billing models to choose from. Pick the one that fits your business:

### Billing Model Comparison

| Feature         | Monthly Fee + Per-Minute         | Monthly Packages                       |
| --------------- | -------------------------------- | -------------------------------------- |
| **Best For**    | Simple, flexible pricing         | Predictable monthly costs              |
| **Client Pays** | Monthly fee + usage charges      | One monthly price (includes minutes)   |
| **Overage**     | No concept of overage            | Charge extra for minutes over limit    |
| **Complexity**  | Simple to explain                | Slightly more complex                  |
| **Example**     | $49/mo + $0.40/min for all calls | $99/mo for 200 min + $0.60/min overage |

### Which Model Should You Choose?

**Choose Monthly Fee + Per-Minute if:**

✅ You want simple, transparent pricing\
✅ Client usage varies widely month to month\
✅ You want clients to pay for exactly what they use\
✅ You prefer SaaS-style "base + usage" pricing

**Choose Monthly Packages if:**

✅ You want predictable monthly revenue\
✅ Clients want to know their base cost upfront\
✅ You offer tiered plans (Starter/Pro/Enterprise)\
✅ You want to encourage higher usage with included minutes

You can also offer both! Different clients can use different models based on their needs.

***

## Billing Model 1: Monthly Fee + Per-Minute

Simple, flexible pricing: charge a monthly platform fee plus usage-based per-minute charges.

### How It Works

```
Monthly Platform Fee: $49/month (via Stripe subscription)
         +
Per-Minute Charges: $0.40/minute (deducted from prepaid balance)
         =
Total Monthly Bill: $49 + usage charges
```

**Example Month:**

Client makes 150 minutes of calls

```
Charges:
├── Monthly Platform Fee: $49.00 (auto-charged by Stripe)
└── Usage Charges: 150 × $0.40 = $60.00 (deducted from balance)

Total: $109.00
```

### Setting Up This Model

<img src="https://mintcdn.com/vapifybykanzucode/A3O19gLqD2_WDy2-/images/billing-setup-der.png?fit=max&auto=format&n=A3O19gLqD2_WDy2-&q=85&s=07c5b57966f026d912aa0890c01a7143" alt="Billing & Usage" width="3450" height="1778" data-path="images/billing-setup-der.png" />

#### Step 1: Configure Monthly Fee

1. In your subaccount billing settings, enable the monthly billing option (if your plan allows)
2. Set Monthly Subscription Fee: eg. \$49.00
3. This creates a Stripe subscription for the monthly fee

#### Step 2: Set Per-Minute Rate

1. In your subaccount billing settings.
2. Set Price per Minute: eg. \$0.40
3. This applies to ALL calls made by this assistant

#### Step 3: Client Loads Balance

Your client needs prepaid balance for per-minute charges:

1. Client logs into their dashboard
2. Clicks Top up Balance
3. Pays via Stripe
4. Balance available immediately

### How Billing Works

**Monthly Subscription (Automated):**

* Stripe auto-charges client on billing anniversary
* Example: If client subscribes on Nov 15, charges every month on the 15th
* Handles failed payments, retries, notifications
* You see revenue in your Stripe Dashboard

**Per-Minute Charges (Real-Time):**

* After each call, system calculates: minutes × per-minute rate
* Amount deducted from client's prepaid balance
* Client sees transaction in their billing history
* Happens instantly when call ends

### Client Balance Management

Client dashboard shows:

```
💰 Account Balance
─────────────────────────
Balance: $150.00
Credits: $25.00 (bonus)
Total Available: $175.00

Monthly Subscription:
Next charge on Dec 15: $49.00
```

**What happens if balance runs low:**

```
⚠️ Low Balance Warning

Your balance is running low ($8.50 remaining).
Add funds to continue making calls.

[Add Funds]
```

**What happens if balance hits \$0:**

```
🔒 Insufficient Balance

Cannot place call - balance is $0.00.
Please add funds to continue.

[Add Funds Now]
```

### Variations of This Model

**Pure Per-Minute (No Monthly Fee):**

```
Monthly Fee: $0
Per-Minute: $0.50
```

Simple pay-as-you-go with no recurring charges.

**High Monthly Fee, Low Per-Minute:**

```
Monthly Fee: $199
Per-Minute: $0.20
```

Premium plan with low usage costs.

**Low Monthly Fee, High Per-Minute:**

```
Monthly Fee: $29
Per-Minute: $0.60
```

Affordable entry, pay more for heavy usage.

### When to Use This Model

**✅ Perfect for clients who:**

* Have unpredictable call volumes
* Want to pay for exactly what they use
* Prefer clear, itemized billing
* Are comfortable loading prepaid balance

**❌ Not ideal for clients who:**

* Want one predictable monthly charge
* Don't want to monitor balance
* Make consistent monthly call volumes
* Prefer "all-inclusive" packages

***

## Billing Model 2: Monthly Packages

Predictable monthly pricing with included minutes and overage charges.

### How It Works

```
Monthly Package: $99/month
Includes: 200 minutes
Overage Rate: $0.60/minute
         ↓
Client uses 230 minutes
         ↓
Charges:
├── Base Package: $99.00 (includes first 200 min)
└── Overage: 30 min × $0.60 = $18.00

Total: $117.00
```

### Usage Dashboard

Client sees in real-time:

```
📊 Current Month Usage
─────────────────────────────────
Used: 187 / 200 minutes (94%)
Remaining: 13 minutes
Resets in: 12 days

Overage charges this month: $0.00
```

**When approaching limit:**

```
⚠️ Approaching Monthly Limit

You've used 195 of 200 included minutes.
Overage rate: $0.60/minute

Need more minutes? Upgrade your plan or add
prepaid balance to cover overage charges.
```

**After exceeding limit:**

```
📊 Current Month Usage
─────────────────────────────────
Used: 227 / 200 minutes
Overage: 27 minutes × $0.60 = $16.20

Next charge on Dec 15:
├── Monthly Package: $99.00
└── Overage: $16.20
Total: $115.20
```

***

## Managing Client Balances

### Understanding Balance Types

Your clients have two "wallets" for prepaid funds:

**Balance 💰 (Green wallet)**

* Loaded by client via Stripe payments
* Client controls when to add funds
* Self-service, automated

**Credits 🎁 (Blue wallet)**

* Added manually by you
* Promotional, bonus, or compensation
* Your discretion

**How they're used:**

```
Credits are always used FIRST, then Balance

Example:
Credits: $25.00
Balance: $75.00
Total Available: $100.00

After $30 charge:
Credits: $0.00 (used first)
Balance: $70.00 ($5 deducted after credits)
Total Available: $70.00
```

### When Balance Is Needed

**Monthly Fee + Per-Minute Model:**

✅ Required for all per-minute charges\
Client must load balance before making calls

**Monthly Package Model:**

⚠️ Only required for overage charges\
If client stays within included minutes, no balance needed\
If client exceeds, balance must cover overage

**Demo Accounts:**

❌ Not required - demo calls are free

### Low Balance Alerts

Automatic client warnings:

**At \$20 remaining:**

```
📧 Email: "Low Balance Alert"

Your Vapify account balance is running low ($18.50).
Add funds to avoid service interruption.

[Add Funds]
```

**At \$10 remaining:**

```
⚠️ Dashboard Banner:
"Low Balance: $8.50 remaining. Add funds to continue service."

[Add Funds]
```

**At \$0:**

```
🔒 Service Suspended

Your balance is $0.00 and you cannot make calls
until you add funds to your account.

[Add Funds Now]
```

**You can customize thresholds:**

1. Go to Agency Settings → Notifications
2. Set warning levels:
   * Warning threshold: \$25
   * Critical threshold: \$10
   * Suspend at: \$0

**Auto top-up (optional):**
Clients can enable auto top-up so their balance replenishes automatically when it drops below a set threshold. This helps avoid service interruptions during high-usage periods.

### Refunding Balance

If you need to refund a client:

1. Go to Clients → Select client → Billing
2. Click Issue Refund
3. Enter details:

```
Issue Refund
─────────────────────────
Amount: $50.00

Refund Method:
○ Stripe Refund (money returned)
○ Account Credit (stays as balance)

Reason:
[ Service issue - refunding unused balance ]

[Process Refund]
```

**Stripe Refund:**

* Money returned to client's payment method
* Shows in their bank/card statement
* Deducts from your Stripe balance

**Account Credit:**

* Stays in client's Vapify balance
* Can use for future calls
* No Stripe transaction

***

## Understanding Profitability

Make sure you're making money on every call!

### The Profitability Formula

```
Your Profit = What You Charge - Provider Cost

Example:
You charge: $0.50/minute
Provider costs: $0.30/minute
Your profit: $0.20/minute (40% margin)
```

### Real-World Example

10-minute call:

```
Provider charges Vapify: $3.00
You charge your client: $5.00
Your profit: $2.00
Profit margin: 40%
```

### Profitability Checks

Vapify automatically prevents unprofitable calls:

**Scenario 1: Profitable Call ✅**

```
Provider cost: $3.00 (10 minutes)
Your price: $5.00 (10 × $0.50/min)
Profit: $2.00 ✅
Result: Call processes normally
```

**Scenario 2: Unprofitable Call ⚠️**

```
Provider cost: $6.00 (10 minutes)
Your price: $5.00 (10 × $0.50/min)
Loss: -$1.00 ⚠️
Result: Call blocked, assistant flagged
```

💡 **Pro tip:** Set prices at \$0.50 or higher to maintain healthy margins as provider costs fluctuate.

***

## Billing Best Practices

### 1. Choose the Right Model for Each Client

**Monthly Fee + Per-Minute:**

* Medical offices with varying call volumes
* Seasonal businesses
* Testing new clients
* Clients who want flexibility

**Monthly Packages:**

* Established clients with consistent usage
* Clients who value predictability
* Higher-value clients
* When you want recurring revenue

### 2. Set Competitive but Profitable Prices

Research your market:

* Check what competitors charge
* Consider your client's industry
* Factor in your service value-adds
* Always maintain 30%+ margin

**Example pricing by industry:**

```
Medical Practices: $0.60 - $0.80/min
  → High value, regulatory compliance

Dental Offices: $0.50 - $0.70/min
  → Moderate volume, appointment scheduling

Real Estate: $0.40 - $0.60/min
  → High volume, lead qualification

General Business: $0.50 - $0.70/min
  → Varies by use case
```

***

## FAQs

<AccordionGroup>
  <Accordion title="Billing Models">
    <h3>Can I mix billing models?</h3>
    <p>Yes! Different clients can use different models:</p>

    <ul>
      <li>Client A: Monthly package ($99/mo, 200 minutes)</li>       <li>Client B: Per-minute only ($0.50/min)</li>
      <li>Client C: Monthly fee + per-minute ($49/mo + $0.40/min)</li>
    </ul>

    <h3>What if I only want to charge per-minute with no monthly fee?</h3>
    <p>Set monthly fee to \$0 and just set the per-minute rate on each assistant.</p>
  </Accordion>

  <Accordion title="Stripe & Payments">
    <h3>What happens if a client's payment fails?</h3>
    <p><strong>For subscriptions:</strong></p>

    <ul>
      <li>Stripe automatically retries failed payments</li>
      <li>Client receives email from Stripe</li>
      <li>After multiple failures, subscription cancels</li>
      <li>You receive notification to follow up</li>
    </ul>

    <p><strong>For balance top-ups:</strong></p>

    <ul>
      <li>Payment fails immediately</li>
      <li>Client sees error message</li>
      <li>Balance not added</li>
      <li>Client must try again</li>
    </ul>

    <h3>Can I offer refunds?</h3>
    <p>Yes:</p>

    <ol>
      <li>Go to your stripe dashboard</li>
      <li>Choose the transaction to refund</li>
      <li>Process refund</li>
    </ol>

    <p>Stripe refunds typically take 5-10 business days to appear in client's bank account.</p>

    <h3>Do I pay any fees to Vapify?</h3>
    <p>No platform fees on payments! You pay:</p>

    <ul>
      <li>Stripe processing fees (\~2.9% + \$0.30 per transaction)</li>
      <li>Your Vapify subscription</li>
    </ul>

    <p>All client payments go directly to your Stripe account.</p>
  </Accordion>

  <Accordion title="Balance & Credits">
    <h3>What's the difference between Balance and Credits?</h3>

    <ul>
      <li><strong>Balance:</strong> Client loads via Stripe (self-service)</li>
      <li><strong>Credits:</strong> You add manually (bonuses, promotions)</li>
      <li>Both used for per-minute charges (Credits used first)</li>
    </ul>

    <h3>Can I remove credits from a client?</h3>
    <p>No - credits are non-refundable once added. Only add what you intend to give away.</p>

    <h3>What happens to unused balance if client cancels?</h3>
    <p>Options:</p>

    <ul>
      <li>Let them use it down to \$0 before canceling</li>
      <li>Issue Stripe refund for remaining balance</li>
    </ul>

    <p>Check your service agreement and local regulations.</p>
  </Accordion>

  <Accordion title="Technical Questions">
    <h3>How quickly are calls billed?</h3>
    <p>Immediately when call ends:</p>

    <ol>
      <li>Call finishes</li>
      <li>System calculates cost</li>
      <li>Balance deducted instantly</li>
      <li>Client sees transaction in billing history</li>
    </ol>

    <p>Real-time billing prevents billing disputes.</p>

    <h3>Can clients see itemized call logs?</h3>
    <p>Yes! Clients can view:</p>

    <ul>
      <li>Date/time of each call</li>
      <li>Duration</li>
      <li>Cost</li>
      <li>Which assistant was used</li>
      <li>Call recordings (if enabled)</li>
    </ul>

    <p>Full transparency builds trust.</p>

    <h3>What happens during system downtime?</h3>
    <p>Calls continue to work! Voice providers (Vapi/Retell) handle calls independently. Billing may be delayed slightly but all calls are eventually billed correctly.</p>
  </Accordion>
</AccordionGroup>

***

Questions? Contact [support@vapify.agency](mailto:support@vapify.agency) or chat with us in your dashboard.
