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 you develop an application that doesn't require dynamic updates to the digital goods (for example, in a game application with a predetermined selection of additional levels), including the digital goods as functionality in the source code can make the most sense.
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 App World™ storefront.
Using a content server to distribute digital goods
If you host your digital goods on a content server, you can notify your content server about successful purchases. You can design your application to programmatically send notifications, or you can permit the Payment Service server to send notifications. To permit direct notifications from the Payment Service server to your content server, you must set up a dynamic license model when you register the digital goods in the vendor portal for the BlackBerry App World™ storefront. When you set up a dynamic license model for your digital goods, you must 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 which describe the successful purchase:
- pin: the BlackBerry® 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 application users receive the digital goods that they purchase. For information about sending data over the wireless network, visit www.blackberry.com/go/devguides to read the BlackBerry Java SDK Network Communication Development Guide.