Rate cards

A rate card is a collection of rates that your customers subscribe to for accessing your services. It is common to offer a few rate cards for your customers to choose from (like starter, pro, enterprise, etc.).

Creating a rate card

You can create a rate card using the API or in the dashboard.

SDK

Create a rate card

rate_card = lark_client.rate_cards.create(
    name="Starter plan",
    description="Perfect for small teams.",
    billing_interval="monthly",
    fixed_rates=[
        {
            "name": "Base rate",
            "code": "base_rate",
            "price": {
                "type": "flat",
                "amount": "2900",
                "currency_code": "usd"
            }
        }
    ],
    usage_based_rates=[
        {
            "name": "AI chat requests",
            "code": "ai_chat_requests",
            "included_units": 100,
            "price": {
                "type": "flat",
                "amount": "50",
                "currency_code": "usd"
            },
            "pricing_metric_id": pricing_metric.id
        }
    ],
)

Dashboard

1. Go to the rate cards page and click “New Rate Card”.
2. Set the name and description with the following values:
   • Name: Starter plan
   • Description: Perfect for small teams.
   • Billing Interval: Monthly
3. Add a fixed rate:
   • Name: Base rate
   • Code: base_rate
   • Price: $29.00 (flat)
4. Add a usage-based rate:
   • Name: AI chat requests
   • Code: ai_chat_requests
   • Price: $0.50 (flat)
   • Included Units: 100
   • Pricing Metric: AI chat requests (from the dropdown)
5. Click “Save”.

Rates

A rate card is made up of one or more rates. Each rate can be fixed or usage-based. Each rate also defines a code that is used to maintain quantities and discounts when customers move between rate cards.

Fixed rates

Fixed rates are charged upfront in a billing cycle. For example, the rate card might have a fixed rate of $20/month per user.

Usage-based rates

Usage-based rates are charged in arrears (i.e. at the end of the billing cycle) based on the quantity from a pricing metric. Usage-based rates can also specify an included quantity (i.e. the quantity that is included for free). For example, the rate card might have a usage-based rate of $0.10 per API call with 100 API calls included for free.

Price types

Each rate is linked to a price. A price defines how a quantity is converted to a amount to be charged. We support the following price types:

• Flat price: A flat price is a price that is charged per each unit. For example, $1 per unit.
• Package price: A package price is a price that is charged per package of units. For example, $10 per 1000 units. You can also specify a rounding behavior to round up or down to the nearest package unit.

Changing a rate card

Lark was designed with pricing changes in mind. You can simply create a new rate card version, set it as the latest version, and customers subscribed to the previous version will automatically be migrated to the new version.