Distributing digital goods

You can distribute digital goods either by sending data files over the wireless network from your own server, or by unlocking existing functionality from within the application's code.

If the digital goods for your application don't require dynamic updates, include the functionality of those goods in the source code. For example, if you sell a game that has a predetermined selection of additional levels, those levels should be included in your application. Your game logic can control access to those levels based on the purchase logic.

If you host your digital goods on a content server and deliver them to BlackBerry devices over the wireless network, you can update and add to your offering of digital goods without having to submit a new release of your application to the BlackBerry World storefront.

Distributing digital goods from a content server

If you host your digital goods on a content server, you can notify your content server about successful purchases in two different ways. You can design your application to send notifications, or you can request a notification from the Payment Service.

To request notifications from the Payment Service, you must set up a dynamic license model when you register the digital goods in the BlackBerry App World vendor portal. When you set up a dynamic license model for your digital goods, provide an HTTPS URL for your content server. After each successful purchase, the Payment Service server sends your content server a request for a license key, as well as the following parameters that describe the successful purchase:

  • pin: the device PIN
  • email: the email address associated with the user's BlackBerry ID account
  • product: the name of the application that the digital goods are purchased from
  • version: the version of the application that the digital goods are purchased from
  • transactionid: a unique identifier for the successful purchase
  • sku: the SKU
  • test: true or false depending on whether the purchase is initiated using a BlackBerry ID account that is configured for testing

After your content server receives the notification, it's up to you to make sure that your users receive the digital goods that they purchase.

Related links

Payment Service