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

# Billing Overview

> Configure billing settings in Aikeedo including default currency, trial periods, sign-up plans, and fallback subscriptions for user onboarding.

## General Settings

### Billing Address

Control whether billing address information is required during checkout.

* **Enabled**: Billing address will be required at checkout
* **Disabled**: Billing address is optional

<Note>
  Address information is required by payment gateways in some countries for compliance and fraud prevention.
</Note>

### Credit Overuse Allowance

Manage how overused credits are handled when users exceed their plan limits.

* **Enabled**: Overused credits are tracked as workspace debt and automatically deducted from future subscription renewals or credit purchases
* **Disabled**: Overused credits become lost revenue that cannot be recovered

<Info>
  This feature helps recover revenue from overused credits while still maintaining usage limits. Workspaces with negative balance are still blocked from new operations until debt is covered.
</Info>

### Charge for Automatic Title Generation

Control whether automatic title generation incurs a cost.

* **Enabled**: Title generation incurs a cost and is charged to the workspace
* **Disabled**: Title generation is provided free of charge

### Charge for Dictation

Control whether dictation features incur a cost.

* **Enabled**: Dictation incurs a cost and is charged to the workspace
* **Disabled**: Dictation is provided free of charge

### Default Currency

Choose the default currency for your billing system. This setting affects how prices are displayed and transactions are processed throughout your Aikeedo platform.

<Tip>
  While it's important to choose a currency supported by your payment gateway, Aikeedo offers flexibility in currency handling. Each payment gateway provides a currency selector with supported currencies. If a selected currency isn't directly supported, Aikeedo can convert it to a supported currency during checkout, provided a currency rate provider is set up.
</Tip>

<Note>
  If the currency option is not set or is set to "Inherit" for payment gateways, the default currency will be used. Ensure you have a currency rate provider configured if you plan to use currencies not directly supported by your payment gateway.
</Note>

### Currency Rate Provider

Select a provider for currency exchange rates. Options include:

* **None**: No automatic currency conversion.
* **CurrencyAPI**: Uses the CurrencyAPI service for up-to-date exchange rates.

<Note>
  Additional currency providers can be added through plugins, expanding your options for managing multi-currency transactions.
</Note>

### Detailed Pricing Page URL

Configure where the **Detailed pricing table** button on the in-app Plans page links.

* Use `/#pricing` to point to the built-in landing page pricing section
* Use a full URL (for example, `https://yoursite.com/pricing`) when you use an external marketing site
* Leave empty to hide the button on the Plans page

<Tip>
  If you disable the built-in landing page and host pricing on WordPress, Webflow, or another external site, set this URL so the Plans page button does not link to a broken anchor. See [Landing Page Customization](/website-basics/landing-page).
</Tip>

### Credits per Currency

Set how many credits equal one unit of your default currency. This setting is shared across billing modes.

* In **credit metering** mode: converts currency amounts to credits when users purchase add-on credits at checkout

* In **session-based usage** mode: converts add-on credit balances to currency for display in the app

* Enter the number of credits users receive per unit of your default currency

* Example: 100 credits per \$1.00 USD

<Note>
  In session-based usage mode, this field appears under **Usage mode**. In credit metering mode, it appears under **Custom Credit Purchases** when add-on purchases are enabled.
</Note>

## Trial Configuration

### Trial Period Days

Set the duration of the trial period for new users.

* Enter the number of days for the trial period.
* Set to 0 to disable the trial feature.

<Info>
  Each user is eligible for a trial only once across any paid plan.
</Info>

### Trial Without Payment

Toggle this option to allow users to start a trial without providing payment information upfront.

* When enabled, users can upgrade to any paid plan during the trial without immediately providing payment details.
* After the trial ends, a payment method will be required to continue the subscription.

## Default & Fallback Plans

### Sign Up Plan

Select the plan to which new users will be automatically subscribed upon registration.

* Choose "None" to disable automatic subscription, requiring users to select a plan themselves.
* Only monthly or yearly recurring plans can be set as the Sign-Up plan.

<Info>
  New users are automatically subscribed to the Sign Up plan, regardless of the trial option. If a trial period is set, users will be downgraded to the Fallback plan after the trial ends. Without a trial, users continue on the Sign Up plan.
</Info>

<Warning>
  If selecting a paid plan as the Sign Up plan, it's crucial to enable the trial period. Otherwise, new users will have immediate access to paid features without payment, which could lead to potential revenue loss.
</Warning>

### Fallback Plan

Define the plan users will be automatically moved to if their current subscription expires or fails to renew.

* Choose "None" to disable automatic downgrading, requiring users to manually select a new plan.
* Only monthly or yearly recurring plans can be set as the Fallback plan.

<Note>
  Ensure you have created appropriate pricing plans before configuring the Sign-Up and Fallback plans to provide a smooth user experience.
</Note>

## Usage Mode

Choose how usage limits are presented and enforced site-wide at **Settings > Billing > Usage mode**. Credits remain the internal billing unit in both modes.

### Credit Metering (default)

The default mode. Users see credit balances throughout the app.

* Monthly plan credits are the only usage pool
* No session windows or pacing
* Usage logs remain visible

### Session-Based Usage

An alternative that hides credit balances and paces usage through configurable session windows for a smoother, "limitless" feel — this is not unlimited usage.

* Users see session usage as a percentage and when the current session resets
* Credit balances are hidden app-wide; add-on balances display as currency
* A dedicated usage page is available at `/app/billing/usage`
* Usage logs are hidden and redirect to the dashboard
* When the session cap is reached, a limit banner appears in chat with a **Buy usage credits** call to action

#### Session Duration

Set how long each usage session lasts (1–24 hours). Each workspace session starts on first billable usage and resets after the configured duration.

The session cap is calculated from the plan's monthly credits and session duration:

```
floor(monthly_credits × session_hours / (30 × 24))
```

Plans with unlimited monthly credits skip the session cap.

#### How Limits Are Enforced

1. Monthly plan credits are checked first
2. If credits remain, usage is allowed and counts toward the session cap
3. When the session cap is reached, add-on credits allow continued usage
4. If no add-on credits are available, new operations are blocked until the session resets

<Info>
  For add-on credit behavior in session mode, see [Plans, Snapshots & Subscriptions](/billing/plans-snapshots-subscriptions#add-on-credits).
</Info>

#### BYOK in Session Mode

Workspaces using BYOK (Bring Your Own Key) for OpenAI or Anthropic skip session gates when usage is zero-cost for those providers. Other models still consume credits and count toward the session cap. See [BYOK](/advanced/byok).

## Custom Credit Purchases

### Enable Custom Credit Purchases

Allow users to purchase additional credits beyond their subscription plan.

* **Enabled**: Users can purchase additional credits with custom amounts
* **Disabled**: Users can only use credits included in their subscription plan

### Credits per Currency

When custom credit purchases are enabled in **credit metering** mode, set the exchange rate here. See [Credits per Currency](#credits-per-currency) under General Settings for details.

### Minimum Purchase Amount

Set the minimum amount users must spend when purchasing credits.

* Enter the minimum purchase amount in your default currency
* Example: \$10.00 USD minimum purchase

### Maximum Purchase Amount

Set the maximum amount users can spend in a single credit purchase.

* Enter the maximum purchase amount in your default currency
* Example: \$15,000.00 USD maximum purchase

<Note>
  These limits help control credit purchase volumes and prevent potential abuse while providing flexibility for high-volume users.
</Note>

## Related Guides

* [Unified Credit System](/billing/unified-credit-system) - Understand credit management
* [Plans, Snapshots & Subscriptions](/billing/plans-snapshots-subscriptions) - Create and manage plans
* [Stripe Integration](/integrations/stripe) - Configure Stripe payments
* [PayPal Integration](/integrations/paypal) - Configure PayPal payments

<Tip>
  Test your billing configuration thoroughly with test accounts before launching to ensure a smooth user experience.
</Tip>