Registering with BlackBerry World

When you submit an app for review in the vendor portal for the BlackBerry World storefront, you must also add the details about the digital goods that your app offers. You must provide the name, the SKU (the unique identifier for the digital goods), the license model (consumable or one-time payment), the pricing tier, and a description of the digital goods in each language that your app is available.

For more information about submitting apps and digital goods, see the  BlackBerry World documentation.

Add digital goods to an app

Before you begin selling digital goods in your app, you must register your app in the vendor portal for the BlackBerry World storefront and add information about the digital goods you plan to sell. For more information about registering your app, see Adding apps to BlackBerry World. To add information about the digital goods in your app, see Add digital goods.

Registration information for digital goods

Here's what you must specify when you add digital goods in the BlackBerry World vendor portal.

Name of good
This field specifies the name that identifies the digital goods that you sell in an app.
SKU
This field specifies the SKU that identifies the digital goods that you sell in an app. When a user initiates a purchase of digital goods in your app, the Payment Service server can use the SKU to identify the digital goods. If you are developing a Cascades app and you want to use one SKU to identify multiple digital goods, you can differentiate between the digital goods by including the  purchaseMetadata argument in requestPurchase(digitalGoodId, digitalGoodSku, digitalGoodName, purchaseMetadata, &extraParameters).
License type
This field specifies a license type for the digital good. You can select one of the following options:
  • Non-consumable: This license type permits users to purchase a digital good only once. If you use this license type, you must make sure that the digital goods are available for the minimum time period after the user downloads the app that the digital goods are associated with. For more information about the minimum period that is defined in the license agreement, visit na.blackberry.com/developers/legal.jsp.You must also make sure that digital goods are still available if the user reinstalls the app or switches devices. Digital goods aren't restored automatically, so it's up to you to make sure that users can download these digital goods again.
  • Consumable: This license type permits users to purchase the same digital goods more than once.
  • 7-day subscription: This license type permits users to purchase subscription-based digital goods that have a renewal period of 7 days.
  • 30-day subscription: This license type permits users to purchase subscription-based digital goods that have a renewal period of 30 days.
Initial trial period
This field specifies the duration of the initial trial period for subscription-based digital goods. This field appears only if you select the 7-day subscription option or 30-day subscription option in the License type field.
Price
This field specifies the price that users pay for non-consumable and consumable digital goods. You can specify a price from a list of pricing tiers that BlackBerry World provides. For subscription-based digital goods, the price that you specify in this field indicates the price of 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
This field specifies the price that users are charged for subscription-based digital goods. Users are charged this amount after the initial trial period expires and every 7 days or 30 days thereafter, depending on the license type of the subscription-based digital goods. This field appears only if you select the 7-day subscription option or 30-day subscription option in the License type field.
License model
This field specifies if license keys are required, and how they are distributed. You can specify a license model that requires users to provide a license key to use the digital goods. You can select one of the following options:
  • Static: Users do not require a license key.
  • Single: You must provide a single license key that all users can use.
  • Dynamic: You must provide a web address for a website that generates license keys. After a user purchases the digital goods, the Payment Service server connects to the website, retrieves the license key, and provides the user with the license key. This license model is required if you want your content server to receive notifications when users make purchases in your app. For more information about dynamic licensing, visit the BlackBerry World FAQ.
  • Pool: You must provide a pool of unique license keys that BlackBerry World can use to distribute a license key to each user. The pool must contain at least 100 license keys.

    If the number of license keys in a pool decreases to 50, BlackBerry World sends you an email message that instructs you to add more license keys. 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 message that notifies you to add more license keys.

Last modified: 2014-09-30



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus