Fund Usage After a Purchase

Do not emulate credits by sending negative customer-usage events. Those events can change a Sum meter’s aggregate, but they are not recorded as first-class credited units. Use the Usage credits benefit when the balance must distinguish issued credits from consumed usage.

Product model	Credit behavior
One-time product	The configured units are issued once after purchase.
Subscription	The configured units are issued at the start of each billing cycle.

Product model

Credit behavior

One-time product

The configured units are issued once after purchase.

Subscription

The configured units are issued at the start of each billing cycle.

Configure the flow

Create a usage tracker

Open Products → Meters, create the tracker that measures the billable activity, and save it.

Create the benefit

Open Products → Benefits, create a Usage credits benefit, select the usage tracker, and set the number of units to issue.

Choose rollover behavior

Enable Carry unused credits over only when remaining subscription credits should carry into the next cycle. Changing this setting affects newly issued credits, not credits already granted.

Attach it to the product

Add the benefit to the one-time or recurring product that should fund usage, then save the product.

Verify in sandbox

Complete a sandbox checkout and read the customer’s meter balance. For subscriptions, repeat the check after a test cycle to confirm the recurring grant.

Read the resulting balance

Use the Customer Meters API when your application needs to inspect the credited, consumed, and remaining units for a customer.

import { Ruba } from "@getruba/sdk";

const ruba = new Ruba({
  accessToken: process.env.RUBA_ACCESS_TOKEN ?? "",
  server: "sandbox",
});

const meters = await ruba.customerMeters.list({
  customerId: "<customer_id>",
});

for (const meter of meters.result.items) {
  console.log({
    meterId: meter.meterId,
    creditedUnits: meter.creditedUnits,
    consumedUnits: meter.consumedUnits,
    balance: meter.balance,
  });
}

For the benefit’s full configuration rules, see Usage credits.

Launch Path

Shape the Offer

Run the Revenue Model

Deliver Customer Access

Build the Integration

Operate the Business

Implementation Playbooks

Fund Usage After a Purchase

Choose when credits are issued

Configure the flow

Read the resulting balance

​Choose when credits are issued

​Configure the flow

​Read the resulting balance

Choose when credits are issued

Configure the flow

Read the resulting balance