Granting Bonuses

Web App
API + SDK

To grant bonues to customers via the Web App…

Go to customer details page

Go to the customers page and find and click on a customer.

Click grant bonus

Scroll down to the bonuses section and click the Grant Bonus button

Bonuses section in customer details page in PriceOS

Set options

Select a feature, input an amount, and optionally set a reason and expiration date

Save

Click the Grant Bonus button

You can use the create bonus endpoint to grant bonuses to a customer.

const result = await priceos.bonuses.create({
  customerId: "customer_123",
  featureKey: "api_calls",
  amount: 100,
  expiresAt: Date.parse("2026-12-31T23:59:59.000Z"),
  reason: "promotion",
  metadata: {
    campaign: "winter_promo",
  },
});

How Bonuses Work Displaying Bonuses