Registering with BlackBerry World

When you submit an application in the BlackBerry World vendor portal, you can also add digital goods to your application. When you add digital goods, you need to provide details, including the following information that may become data in payment service transactions.

Name of good

The Name of good field specifies the name of the digital good that you sell in an application. You can change how the name of the digital good appears on the purchase confirmation dialog box using the digitalGoodName argument in the blackberry.payment.purchase function.

SKU
The SKU is an identifier that you can use to manage your digital goods. When a user initiates the purchase of digital goods in your application, the Payment Service server can use the SKU to identify the digital goods.

If it is impractical to create a separate name and SKU for each of your digital goods, you can use the same name and SKU for multiple digital goods. For example, if you sell streaming video through your application, you can use one name and SKU for the digital goods that you sell at a particular price tier. In this scenario, you might add digital goods with the name "Video $4.99" and use the same SKU for every streaming video that you sell at the $4.99 pricing tier. This way you can update the purchase options without submitting a new version of your application. When you call the  blackberry.payment.purchase function in your app, you can pass a metadata argument that allows you to differentiate between digital goods that reference the same SKU.

License type
You can select one of the following license types for your digital good:

Consumable: A consumable license is temporary, like a movie rental. Users can purchase this type of digital good more than once.

Non-consumable: A non-consumable license is for permanent enhancements, like extra levels of a game. If you use this license type, you must make sure that the digital good is available for a minimum time period as defined in the BlackBerry SDK Licence Agreement. You must also make sure that digital goods are still available if the user reinstalls the application or switches devices. Because digital goods are not automatically restored, it's up to you to make sure that users can access these digital goods again.

7-day Subscription: A 7-day subscription provides users with renewable content, like news publications, with a renewal period of 7 days.

30-day Subscription: A 30-day subscription provides users with renewable content with a renewal period of 30 days.

Initial trial period
If you decide to offer digital goods as 7-day or 30-day subscriptions, you can set an initial trial period for the subscription.
Price
You can specify a price for your digital goods from a list of pricing tiers that BlackBerry World provides. For subscription-based digital goods, the price that you specify in this field is for the initial trial period. You can provide a free trial for your subscription-based digital goods by specifying a price of $0.00
Renewal price
If your digital goods are subscription-based, you can use this field to set the price for a renewal period, to begin after the initial trial period expires. Users are charged this amount every 7 days or 30 days after the trial period expires, based on the license type.
License model
You may want to require that users have a license key in order to run your digital goods. You can select any of the following license models to define a license key method for your digital goods.

Static: A static model doesn't use a license key.

Single: With a single license key, all users get the same license key to access your digital goods.

Dynamic: If you select a dynamic license model, you must provide an address for a website that generates license keys for your digital goods. After a user purchases your digital goods, the Payment Service server connects to the website, retrieves the license key, and provides it to the user. Choose this license model if you want your content server to receive notifications when users make purchases in your application.

Pool: For a pool licence model, you are responsible for providing a pool of unique license keys that BlackBerry World can use to distribute a unique key to each user. The pool must contain at least 100 license keys. If the number of available license keys in the pool decreases to 50, BlackBerry World sends you an email notification. If the number of license keys in a pool decreases to 10, BlackBerry World cancels distribution of the digital goods and sends you an email notification.

Learn more about submitting applications and digital goods on the BlackBerry World vendor portal.

Last modified: 2013-08-14