Skip to main content

Example: One-time charge pricing

The following provides examples of how you could leverage the subscription commerce platform to implement the one-time charge pricing model. In this use case, a fictional client, Film Now, has a portal where customers can create an account on the Film Now website and then start to buy or rent movies using the Cleverbridge platform.

Important

Notifications are an essential part of the pricing model setup. For more information about changing or adjusting your notification settings, see Manage Notifications.

Process a transaction​

To process a transaction, Film Now does the following:

  1. When a customer wants to buy or rent a movie, Film Now creates a session URL using the following API route: /urlgenerator/generateusersessionurl. This creates a link to a checkout process where the customer can complete or update the Cleverbridge payment profile and complete the transaction.
Example

The following is a sample checkout URL, which is submitted as the TargetUrl in the API call: https://<secure.yourdomain.com>/<your client account ID>/purl-checkout?internalcustomer=<uuid-of-the-customer>&cart=<ID of the movie>&firstname=<name>&lastname=<name>

note

When you create the session URL, you can predefine user information such as firstname, lastname, or emailaddress. For a list of the available parameters, see Checkout Process Parameters > Customer Data.

note

To assign the transaction to a customer in your database, use the internalcustomer parameter to implement Single Sign-On (SSO). When the customer buys additional products or services, Cleverbridge will pre-populate the billing profile and simplify the buying process, increasing the conversion rate. For more information, see Single Sign-On (SSO).

  1. Film Now redirects the customer to the link found in the API response. The customer can then modify the payment profile and submit a payment.
note

If the customer chooses an offline payment, you receive a NewOfflinePaymentPurchaseNotification. Use this notification to provide payment instructions in the Customer Self-Service portal. For more information, see Offer global payments.

  1. Once Cleverbridge receives a payment confirmation, Film Now receives a PaidOrderNotification. For more information, see Notification Types.

  2. Film Now entitles the customer to the product, and Cleverbridge simultaneously sends the customer a confirmation email with an invoice.

note

You can import all information for a transaction immediately, including links to the invoice. Alternatively, you can use the following API route to get all relevant transaction details: /purchase/getpurchase.

Update payment profile​

To allow customers to keep their payment profile up-to-date and avoid involuntary churn, Film Now integrates the self-service change payment process that Cleverbridge offers into their website.

Example

The following are the elements you need to create a change payment link: https://<your secure hostname>/<your client account ID>/scp/S<subscription ID>-<subscription Secret> For more information, see Permanent links.

Update billing contact​

To keep the billing contact information of the customer in sync with their CRM, Film Now does the following:

  1. Film Now calls the following API route: /subscription/updatecontact. The API call includes:

    • Updated contact information
    • CustomerReferenceID

  2. Film Now receives a CustomerProfileUpdateNotification.

Issue partial refund​

When a customer receives a partial refund due to reasons such as missing a valid VAT ID or a complaint, Film Now receives a PartialRefundNotification. Film Now then adds the refund document to the list of invoices in the customer’s Self-Service portal.

Issue full refund​

When a customer receives a full refund, Film Now receives a FullRefundNotification. If the entitlement is still active, Film Now disentitles the customer to watch the movie.


Did you find this doc useful?