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.
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.
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.
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.
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.
Last modified: 2014-10-09