Standards for digital goods
A digital good, sometimes called an in-app digital good, is additional content that can be purchased for an app, and can be permanent, temporary, or consumable content. BlackBerry reviews and approves digital goods using the same process that is used for any apps that you submit.
When you add a digital good for an app, you specify a name, SKU, license type, and descriptions, but you do not upload binaries or file bundles for the digital good. Instead you must design your app to give users access to the digital good.
Digital goods have their own license types:
- Consumable licenses for temporary products, such as movie rentals.
- Non-consumable licenses for permanent enhancements, such as extra levels of a game.
- Subscriptions for renewable content, such as news publications.
When you offer non-consumable digital goods, you must verify that the digital goods are available to the user for the minimum time period that is defined in the BlackBerry SDK License Agreement.
You must verify that the digital goods remain available if the user removes the app from a BlackBerry device and installs the app again. You might need to develop a process that queries the Payment Service server for records of previous purchases of digital goods on each app launch. Learn more about Payment Service for details on retrieving records of existing purchases.
- 7-day subscription: Users can purchase the digital good or use it for a
trial period that you specify. You can set a subscription price and a length for the
initial trial period.
The initial trial period can be 0, 1, 2, 3, 4, 5, 7, or 14 days. Selecting "0" as the initial trial period does not allow a trial and the customer is charged the full subscription price.
- 30-day subscription: Users can purchase the digital good or use it for
a trial period that you specify. You can set a subscription price and a length for the
initial trial period.
The initial trial period can be 0, 1, 2, 3, 4, 5, 7, 14, 16, 30, 45, 46, or 60 days. Selecting "0" as the initial trial period does not allow a trial and the customer is charged the full subscription price.
When an initial trial expires, the subscription is automatically renewed as a paid subsctiption and the customer is charged the full subscription price. The customer can cancel at any time between the beginning of the trial period and the start of the paid period.
If you are defining digital goods for a BlackBerry OS or PlayBook app, you need to select a license model as well as a license type. License models for digital goods have the same requirements as license models for apps:
- Static: Users do not need a license key to run the digital good.
- Single: You must provide a single license key that all users can use to run the digital good. You specify the license key in the License Key field when you add your digital good to the vendor portal.
- Dynamic: You must provide an address for a website that generates license keys. After a user purchases the digital good, the server for the BlackBerry World storefront connects to the website, retrieves the license key that the predetermined algorithm generated, and provides the user with the license key. If you select a Dynamic license model when adding a new digital good on the vendor portal, an HTTP URL field appears that lets you specify the web address for a license key. For more information about dynamic licensing, visit Dynamic License Flow.
- Pool: You must upload a .txt
file that contains unique license keys (one key on each line). BlackBerry World
distributes a unique license key to each user that purchases the digital good. When you add
a new digital good on the vendor portal and select the Pool license model, an Upload License
File button appears so that you can upload your .txt file.
Your .txt file must contain at least 100 unique license keys. If the number of license keys drops to 50 or fewer, BlackBerry World sends you an email message requesting that you add more license keys. If the number of license keys drops to ten or fewer, BlackBerry World cancels the distribution of your digital good and sends you an email message requesting that you add more license keys.