Add digital goods to an application

Before you begin: Add details about the application.
  1. On the vendor portal for the BlackBerry App World storefront, in the left pane, click Manage Products.
  2. On the Manage Products screen, in the Goods column, click Add next to the application that you want to add digital goods to.
  3. On the Add a Virtual Good screen, complete the instructions.
  4. To save the information about the digital good, click Save.
  5. To save the information about the digital good and add another digital good, click Save and Add Another.

Submission information for digital goods

The following table describes the fields that you must specify when you submit digital goods in the vendor portal for the BlackBerry App World storefront.

Field

Description

Name of good

This field specifies the name that identifies the digital goods that you sell in an application. You can change how the name appears in your application by invoking the withDigitalGoodName() purchase argument in your application.

SKU

This field specifies the SKU that you can use to identify the digital goods that you sell in an application. When a user initiates purchases of digital goods from within your application, the Payment Service server can use the SKU to identify the digital goods. If you want to use one SKU to identify multiple digital goods, you can differentiate between the digital goods by invoking the withMetadata() purchase argument in your application.

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 does not permit a user to purchase the same digital goods more than once (otherwise known as one-time payment). 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 application, through the application that the digital goods are associated with. For more information about the minimum time period that is defined in the RIM SDK 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 application or switches devices. Digital goods aren't automatically restored, 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 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 (in days)

This field specifies the duration of the initial usage period for subscription-based digital goods.

This field appears only if the "7-day subscription" option or "30-day subscription" option is selected in the License type field.

Price

This field specifies the price that users pay for the digital goods. You can specify a price from a list of pricing levels that BlackBerry App 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 recurring 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, based on the license type of the subscription-based digital goods.

This field appears only if the "7-day subscription" option or "30-day subscription" option is selected in the License type field.

License model

This field specifies how to distribute the license keys that users require to use 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 that the predetermined algorithm generated, 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 within your application.

    For more information about dynamic licensing, visit na.blackberry.com/eng/developers/appworld/faq.jsp.

  • Pool: You must provide a pool of unique license keys that BlackBerry App 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 drops to 50, BlackBerry App World sends you an email message that instructs you to add more license keys. If the number of license keys in a pool drops to 10, BlackBerry App World cancels distribution of the digital goods and sends you an email message that notifies you to add more license keys.

Back To Top

Was this information helpful? Send us your comments.