Payment Service

When you are creating an awesome app, you might want to offer in-app purchases. The Payment Service lets you do just that. When you include the Payment Service classes in your app, you can sell any digital goods that you register in the vendor portal for the BlackBerry World storefront.

You can create purchase opportunities in your app:

  • Sell guides that help users learn about levels, back doors, and bonus points.
  • Offer additional levels or new characters in your game.
  • Upgrade your users to the advanced version of your app.
  • Sell extra services, such as music or video streaming in your app.
  • Offer items such as eBooks, personalized greeting cards, photos, and maps.
  • Sell subscriptions to renewable goods, such as magazines or newsletters.

To use the Payment Service, your app must be distributed through BlackBerry World and your digital goods must be associated with your app in the vendor portal. To learn more about registering apps and digital goods, see Registering with BlackBerry World.

How does it work?

The Payment Service functions are designed to make the user experience consistent for each type of payment and for each BlackBerry 10 device. The following diagram shows what happens when a user wants to use your app to purchase digital goods:

Flow diagram showing the payment process when a digital good is purchased.

  1. A user makes a request to purchase digital goods in your app.
  2. Your app builds the Payment Service information that it needs to make a purchase and then your app initiates a purchase request.
  3. If the user isn't logged in with a BlackBerry ID, the Payment Service prompts the user to log in without leaving your app.
  4. The Payment Service prompts the user to confirm the purchase. The user can change the payment method or set up a new payment method.
  5. The Payment Service verifies that the digital goods are registered and completes the purchase through the payment provider that the user selects.
  6. The Payment Service provides a receipt for the purchase and your app displays the receipt in your UI.
  7. If there is a problem with the transaction, the Payment Service provides the error code and your app handles the exception.

Last modified: 2015-03-31

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

comments powered by Disqus