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 paymentservice.h header into your app, you can offer subscriptions, charge for additional features, or sell any digital goods (virtual items) that you register in the vendor portal of the BlackBerry World storefront.

You can use your imagination to create opportunities for in-app purchases of digital goods in your app:

  • Sell guides to 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.
  • Offer items such as eBooks, personalized greeting cards, photos, and maps.
  • Sell subscriptions to renewable goods, such as magazines and newsletters.

What can the Payment Service offer?

A simple payment solution

The Payment Service manages the technical and financial details for you. You don't have to waste time managing relationships or business terms with payment providers. You don't need to provide coding for integration into each payment provider's solution.

A fast and familiar payment experience for end users

With a BlackBerry ID, users can apply various payment methods, including credit card, PayPal, and carrier billing, toward the purchase of the digital goods that you define—all without leaving your app.

An easy way for you to keep track of your earnings

In the BlackBerry World vendor portal, you can manage and track sales of your app and its digital goods. Then, you can keep track of how much you're earning.

How does it work?

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. Digital goods in your app are described and priced according to the pricing tiers presented in the BlackBerry World vendor portal. The Payment Service functions are designed to make the user experience consistent for each type of payment on each BlackBerry 10 device. The following process flow shows what happens when a user wants to use your app to purchase digital goods.


This diagram shows the payment process in a  flow diagram.
  1. A user makes a request to purchase digital goods in your app.
  2. Your app builds the Payment Service information that the app needs to make a purchase and then your app sends a purchase request.
  3. If the user isn't signed in with a BlackBerry ID account, the Payment Service prompts the user to sign 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 that you created.
  7. If there is a problem with the transaction, the Payment Service provides the error code and your app handles the exception.

Last modified: 2013-12-21



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

comments powered by Disqus