Get started with prepaid credits

To charge customers via prepaid credits, define a plan with the credit_only settlement mode. All usage settles against credits. If a customer runs out of credits, uncovered usage creates a negative credit balance on the ledger rather than generating an overage invoice.

1. In the Konnect sidebar, click Metering & Billing.
2. Click Product Catalog.
3. Click the Plans tab and create a new plan.

4. In the Billing section, configure the Currency (for example, USD) and set the Settlement mode to Credits only.

   Note: Besides fiat currencies, you can select a custom currency that you defined for your organization.

5. Click Add Rate Card and select the feature you want to price.
6. Configure a Usage based pricing model and set your price per unit.
7. Save the rate card and click Publish Plan.

Customers represent the individuals or organizations that subscribe to plans and consume your metered features.

1. In the Konnect sidebar, click Metering & Billing.
2. In the Metering & Billing sidebar, click Billing.
3. Click Create Customer.
4. Enter the customer’s Name.
5. In the Usage Attribution section, use Include usage from to select the Gateway Consumers, AI Gateway Consumers, Dev Portal Applications, or Generic Subjects whose usage belongs to this customer.
6. Click Save.

Subscriptions link customers to a pricing model and track their usage against rate cards.

1. On the customer’s details page, click the Subscriptions tab.
2. Click New Subscription.
3. In Subscribed Plan, select the credits-only plan you created.
4. From the Start subscription dropdown menu, select “Immediately” or “At a specific date”.
5. If you selected “At a specific date”, in the Start date field, enter the date and time the subscription starts.
6. Keep the Settlement mode that the form fills in from the plan.
7. Click Start Subscription.

Prepaid credits burn down as the customer’s usage is billed. Issue a grant directly to the customer’s balance.

1. On the customer’s page, click the Credits tab.
2. Click Grant Credits and select New credit grant.
3. In the Grant section, enter the Credit amount.
4. In the Charge section, set Charge Type to Promotional · Free.
5. Optionally, expand Policies and set Credit draw-down priority, from 1 to 100, to control consumption order if this customer has multiple grants. Lower numbers are consumed first.
6. Click Next to review the Grant Summary.
7. Click Grant credits to finalize.

A funded movement is recorded in the customer’s transaction history and their settled balance increases immediately.

After the grant is issued, the customer’s available balance reflects the new credits. Because this customer is on a credit_only plan, metered usage automatically deducts from this balance. consumed movements appear when usage charges are booked. Before that, the Live balance on the Credits tab already reflects the expected consumption.

1. On the customer’s page, click the Credits tab.
2. Review the Settled balance, Live balance, and Pending balance.
3. Scroll to the Transaction History card.

You’ll see:

• A funded movement with a positive amount for the grant you issued.
• consumed movements with negative amounts as usage charges are booked.
• The running balance before and after each movement.

For more on movement types, pagination, and corrections, see Credit transaction history.