Testing apps with a sandbox user account

You can test purchasing and downloading your apps and digital goods by using a sandbox user account. When you sign in to the BlackBerry World storefront with a sandbox user account, you can access apps that have been added to the vendor portal but are still in a draft state. When you use a sandbox user account to purchase your apps, you are not charged.

You can associate a maximum of ten sandbox user accounts (each with a unique BlackBerry ID) with your vendor account. This is how you create a sandbox user account:

  1. Log in to the BlackBerry World vendor portal with a user account that has Admin level priviledges, and click Testers in the left pane.

  2. Click New Tester. Complete the form to create a new sandbox user account.
  3. Click Save to add the new sandbox user account to the list of existing sandbox user accounts.

You can modify or delete the sandbox user accounts from the same screen, using the Menu button to the right of each tester's name in the list.

Purchasing and downloading apps

After you create a sandbox user account, you can start testing your apps and digital goods on BlackBerry World. Here's what you need to do with your app and your BlackBerry 10 device to get started:

  1. On your device, navigate to Settings > Security and Privacy > Development Mode and tap the Use Development Mode toggle switch to turn on development mode.
  2. Start BlackBerry World on your device and swipe down from the top bezel to display the application menu.
  3. Tap Settings > Development Mode, then enter the ID or SKU of your app and tap Load to download your app.

    This Development Mode screen, where you can enter the ID of your application and download it while it remains in draft status, will be visible only if your device is in Development Mode.

    Tapping the Settings icon at the upper right of the screen leads to a list of options that include Development Mode. The Development Mode screen provides a field where you can enter the Content ID or SKU of your app.

Here's how to test your app with a device running BlackBerry 7 or earlier:

  1. Launch BlackBerry World and select an item from the carousel.
  2. Press and hold the alt key while pressing t, s, and t.
  3. When the dialog box appears, type the Content ID or SKU for your app and click OK.
  4. When the content page for your app appears, click Price.
  5. Enter your sandbox user ID and complete the purchase.

Here's how to test your app on a BlackBerry PlayBook tablet:

  1. Launch and focus on BlackBerry World.
  2. Swipe for the keyboard and press t, s, and t.
  3. Minimize BlackBerry World and launch your browser.
  4. In the address bar, type appworld://content/xxxxx, where xxxxx is the ID or SKU of your app, and click Go.
  5. When the content page for your app appears, click Purchase.
  6. Enter your sandbox user account information, and complete the purchase.

After you install your app, you can make purchases of in-app digital goods without being charged.

All purchases you make will appear on your device as actual purchases, just like the image on the right.

The Confirm Purchase dialog box provides details about the app, the purchase price and the purchase method. You can change the payment method, Cancel, or Purchase the app from this dialog box.

Here are some things to consider when you use a sandbox user account to test your apps and digital goods:

  • Make sure that the connection mode in your app is set to Production so that your test purchases go through the BlackBerry World server.
  • Apps that have a draft status can be downloaded from the BlackBerry World storefront only when you are using a sandbox user account (any other kind of user account won't work).
  • You can retrieve past purchases for the current test session only. Digital goods that are purchased in a draft state are not written to the transaction database, so when you end the test session the cache is cleared.
  • You can test purchasing an app only from a physical device, not from the BlackBerry 10 Device Simulator.
  • BlackBerry World has a cache, so there may be a delay before your new digital goods are accessible from BlackBerry World on your device.
  • You can use a sandbox user account to purchase your own apps and digital goods that are approved and for sale on the BlackBerry World storefront without being charged.
  • If you use your sandbox user account to purchase the apps of another vendor, you will be charged for the purchase.
  • You don’t need to remove an existing app from sale on the BlackBerry World storefront to add new digital goods (that have draft status) and test them with a sandbox user account.
  • If you add a new app (meta data) and digital goods to the BlackBerry World vendor portal, you must also add a release (application data) in order to test purchasing and downloading your digital goods.


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

comments powered by Disqus