Help Center

Local Navigation

BlackBerry Manuals & Help  >  Developer Documentation  >  Payment Service  >  Development Guide Payment Service SDK - 1.0

Submitting digital goods

After you add the details for a new application in the vendor portal for the BlackBerry App World™ storefront, you must also add the details about the digital goods that your application offers. You must provide the name, the SKU (the unique identifier for the digital goods), the license model (consumable or non-consumable), the pricing tier, and a description of the digital goods in each language that your application is available in.

There might be cases in which you want to use the same name and SKU for multiple digital goods. For example, it might be impractical to separately register every streaming video that an application sells. In this case, you could use one name and SKU for the digital goods that you sell at a particular pricing tier. For example, you could register the 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. By using the same SKU for multiple digital goods you can update the purchase options dynamically without submitting a new version of your application. The Payment Service API provides a metadata argument that you can use when initiating a purchase request to differentiate between the digital goods that reference the same SKU.

For more information about submitting applications and digital goods, see the BlackBerry App World vendor documentation at www.blackberry.com/go/appworld/vendordocs/.

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.

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.

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.

Next topic: Distributing digital goods
Previous topic: Code sample: Creating an application that features in-app purchasing

Was this information helpful? Send us your comments.