Skip to main content

Example: Usage-based pricing

CloudBit provides security scans for corporate networks. CloudBit records the scans completed during each billing period and, on the first day of the next month, calculates the customer's charge for the previous period.

Scenario at a glance

Scenario detailValue
OfferCorporate network security scans.
Customer pays forThe scans completed during the billing period.
BillingMonthly, after usage occurs.
Price changes whenMeasured usage changes.
Client responsibilityMeasure usage and calculate the amount to bill.

How sign-up works

Before CloudBit can charge for usage, the customer signs up and creates a payment profile.

  1. CloudBit creates a checkout URL for the subscription.
  2. CloudBit redirects the customer to Cleverbridge checkout.
  3. The customer creates or confirms the payment profile and submits the initial payment.
  4. Cleverbridge sends CloudBit a PaidOrderNotification.
  5. CloudBit activates the service, and Cleverbridge emails the invoice.
Notifications

Notifications connect Cleverbridge transactions to CloudBit's service and customer processes. To configure them, see Manage Notifications. For event definitions, see Notification Types.

Implementation details for sign-up

A sign-up URL can look like this:

https://<secure.yourdomain.com>/<your client account ID>/purl-checkout?cart=<ID of the security scan subscription>&firstname=Han&lastname=Solo

You can predefine customer data such as firstname, lastname, and emailaddress. For all supported parameters, see Checkout Process Parameters > Customer Data.

To use an existing payment profile, generate a session URL and include the customer's UUID. For more information, see Single Sign-On (SSO).

For an offline payment, CloudBit receives a NewOfflinePaymentPurchaseNotification. The CustomerConfirmationPageUrlNotification includes a link to the confirmation page where CloudBit can show payment instructions.

How monthly usage billing works

  1. CloudBit records the security scans performed for each customer.
  2. At the end of the billing period, CloudBit totals the usage.
  3. CloudBit calculates the amount to charge.
  4. CloudBit works with Cleverbridge to process the charge using the agreed implementation.

There is no standard public API flow documented for charging measured usage. Contact Client Experience to define the required implementation.

Let customers purchase more data

For data-limited subscriptions, the customer can renew early or combine a data change with an early renewal. See the following implementation use cases:

Apply a promotion

CloudBit can apply a promotion after making sure the customer's payment information is current:

  1. Update the customer's payment information with /subscription/updateaccount, when applicable.
  2. Submit the promotion with /cart/processcart.

Promotional incentives must first be configured in Cleverbridge. For more information, see Incentivize customers.

Change the payment profile

CloudBit can link to the Cleverbridge self-service change payment process:

https://<your secure hostname>/<your client account ID>/scp/S<subscription ID>-<subscription Secret>

Did you find this doc useful?