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
How the initial purchase works
- Film Now creates a session URL for the selected movie.
- Film Now redirects the customer to Cleverbridge checkout.
- The customer confirms the payment.
- Cleverbridge sends Film Now a
PaidOrderNotification. - Film Now grants access to the movie, and Cleverbridge emails the invoice to the customer.
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.