License models

You can distribute digital goods in your application by using a number of different license models (some of which are supported by the Payment Service). Depending on the license models that your application uses, you may want to customize the way you present purchase options to reflect which digital goods were purchased already.

Consumable

Digital goods that are registered as consumable must be purchased by a user for each use. For example, in a virtual world simulation, you could sell tickets to a virtual attraction or feed for a virtual animal. The Payment Service does not set any controls on the number of times that a user can purchase these goods.

Non-consumable

Digital goods that are registered as non-consumable are purchased only once by a user. The Payment Service server blocks subsequent purchases by the user. In this scenario, you might want to provide a way for users to see their purchase history. By invoking PaymentEngine.getExistingPurchases(), you can retrieve purchase records from the BlackBerry device and the Payment Service server that contain information about a user's past purchases. For more information about retrieving a record of past purchases, see Retrieving information about past purchases.

When you offer a non-consumable digital good, you must ensure that the digital goods are available through your application for a specific period of time after the user downloads the application. To view the required minimum time period in the Research In Motion SDK License agreement, visit http://us.blackberry.com/developers/legal.jsp.

You must also make sure that digital goods are still available if the user reinstalls the application or switches devices. Digital goods are not automatically restored, so it is up to you to make sure that users can download these digital goods again.

Subscription

Digital goods that are registered as a subscription are purchased initially by a user, and the user is charged at regular intervals for continued use of the goods. When you register subscription-based digital goods, you must specify an initial fee and usage period, as well as a renewal fee and usage period. Users are charged the initial fee when they purchase the digital goods and can use the digital goods for the initial period of time. Users are then charged the renewal fee each time the usage period elapses so that they can continue to use the digital goods.

You can implement a trial period for your subscription-based digital goods by not specifying an initial fee. Users can download your digital goods and use them free of charge for the trial period and are charged after the trial period ends.

To purchase subscription-based digital goods in your application, users must be running BlackBerry App World storefront 3.1.

Free

The Payment Service doesn't provide support for free digital goods. Your application can distribute free digital goods, but you cannot use the Payment Service to process transactions for goods with no monetary value.

Next topic: System requirements
Previous topic: Types of digital goods

Was this information helpful? Send us your comments.