Skip to main content

Example: One-time charge pricing

Film Now sells and rents movies through its customer portal. Each movie purchase is a separate transaction: the customer pays once, Film Now grants access, and there is no recurring charge.

Scenario at a glance​

Scenario detailValue
OfferMovie purchase or rental.
Customer pays forOne transaction.
BillingOnce, when the customer completes checkout.
Price changes whenThe customer selects another movie or service.
Client responsibilityCreate the checkout session and grant access after payment.

How the initial purchase works​

  1. Film Now creates a session URL for the selected movie.
  2. Film Now redirects the customer to Cleverbridge checkout.
  3. The customer confirms the payment.
  4. Cleverbridge sends Film Now a PaidOrderNotification.
  5. Film Now grants access to the movie, and Cleverbridge emails the invoice to the customer.
Notifications

Notifications connect the Cleverbridge transaction to Film Now's entitlement and customer-service processes. To configure them, see Manage Notifications. For event definitions, see Notification Types.

Implementation details for the purchase flow

Film Now creates the session URL with /urlgenerator/generateusersessionurl.

A checkout URL submitted as TargetUrl can look like this:

https://<secure.yourdomain.com>/<your client account ID>/purl-checkout?internalcustomer=<uuid-of-the-customer>&cart=<ID of the movie>&firstname=<name>&lastname=<name>

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

Use the internalcustomer parameter to associate the transaction with the customer in your database and support Single Sign-On. For more information, see Single Sign-On (SSO).

If the customer selects an offline payment method, Film Now receives a NewOfflinePaymentPurchaseNotification. Use it to provide payment instructions in the Customer Self-Service portal. For more information, see Offer global payments.

Film Now can import the transaction details from the notification or retrieve them with /purchase/getpurchase.

What makes this pricing model different​

Each checkout creates a standalone purchase. There is no automatic renewal or ongoing seat or usage calculation. A later movie rental is a new transaction.

Common follow-up actions​

These actions apply to an existing purchase; they do not create a subscription.

Update billing contact​

To update customer information, use the relevant customer or subscription contact workflow for your integration. The existing example references /subscription/updatecontact with CustomerReferenceID and a CustomerProfileUpdateNotification; confirm its applicability to a one-time purchase before implementation.

Issue a partial refund​

When Cleverbridge sends a PartialRefundNotification, Film Now adds the refund document to the customer's invoice history.

Issue a full refund​

When Cleverbridge sends a FullRefundNotification, Film Now removes the movie entitlement if it is still active.

Implementation details​

The purchase-specific API calls and notification references appear in the expandable section under the initial purchase flow. The follow-up references above are retained for implementation.


Did you find this doc useful?