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 detail	Value
Offer	Movie purchase or rental.
Customer pays for	One transaction.
Billing	Once, when the customer completes checkout.
Price changes when	The customer selects another movie or service.
Client responsibility	Create the checkout session and grant access after payment.

How a 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.

Common follow-up operations

Update billing contact

Call /subscription/updatecontact with the updated contact information and CustomerReferenceID. Cleverbridge sends a CustomerProfileUpdateNotification.

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.

Did you find this doc useful?