- **Use Case Number:**2-2-07
- Completed By: Software Developer
- Estimated Completion Time: <3 days
Basic Scenario
Single use products allow customers to purchase a service that does not recur. For more information, see Configure Single Use Products Using the Subscribe Portal.Design Approach
Use the Vindicia Subscribe Portal or API to create the single use Product. After the Product is active, rebuild your product catalog cache. The customer can then logs into your storefront application and select the single use product for purchase (which is now displayed because it is active and in the product catalog cache). The storefront uses the attributes of the single use product in conjunction with the customer account and payment information to call the transactions endpoint to create a one-time Transaction. If Entitlements are in scope, upon successful completion of the one-time Transaction, grant the appropriate Entitlements (from the single-event product attributes) to the customer using the accounts endpoint.
Video Use Case Demonstration
In the use case video demonstration, two different examples are covered:- Selling a movie rental as a one time purchase with Entitlements that are granted for a month.
- Selling a digital document as a one time purchase with Entitlements that last for a lifetime.
Create the Single Use Transaction Using Subscribe APIs
- Set up an account with your payment processor of choice.
- Ensure Vindicia has been authorized as a presenter on the payment processor account.
- Set up the single use Product in Subscribe (see Configure Single Use Products Using the Subscribe Portal).
- Create the single use Product in Subscribe using either the Portal or the API.
-
Use the products endpoint to update your product catalog cache.
For example:
GET https://api.staging.us-west.vindicia.com/products:product -
Use the transactions endpoint to create the one-time transaction.
For example:
POST https://api.staging.us-west.vindicia.com/Transactions -
(optional) Use the accounts endpoint to create the entitlements grant for the single use content.
For example:
POST https://api.staging.us-west.vindicia.com/accounts/:account/entitlementsSample Code 2-2-07 Sample Code
- Proper account and payment method objects are created in Subscribe.
- One-time transaction is generated, including taxation if applicable, and charged to the customer’s on-file payment information.
- Account has been granted appropriate entitlements if applicable.

