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 Meter Credits deliverable 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 Catalog → Usage trackers, create the tracker that measures the billable activity, and save it.

Create the deliverable

Open Catalog → Deliverables, create a Meter Credits deliverable, select the usage tracker, and set the number of units to issue.

Choose rollover behavior

Enable Rollover unused credits 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 deliverable 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 deliverable’s full configuration rules, see Meter 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