Payment Service

After you create an awesome app, you might want to offer in-app purchases. The Payment Service lets you do just that. To get started, you need to include the Payment Service classes into your app. Then you can add your app on the vendor portal for the BlackBerry World storefront. You can add digital goods to your app, offer subscriptions, and charge for additional features. Learn more about getting your app up for sale on BlackBerry World.

You can use your imagination to decide what digital goods to create, and how best to offer them for sale from within your app. For example, you can:

  • 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 in your app.
  • 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

You can incorporate the Payment Service in your app and then upload the app and its digital goods, along with pricing and a description to the BlackBerry World vendor portal. The Payment Service manages all the technical and financial details for you. You don't have to waste time managing relationships or business terms with payment providers and coding for integration into each provider's solution.

A fast and familiar payment solution for end users

The Payment Service provides a fast and familiar purchase experience for your users. Using their BlackBerry ID, users can apply various payment methods, including credit card, PayPal, and carrier billing, toward the purchase of digital goods you define—all without leaving your app.

An easy way for you to keep track of your earnings

Digital goods in your app are described and priced according to the pricing tiers presented in the BlackBerry World vendor portal. In the vendor portal, you can manage and track sales of your app and its digital goods so you can keep track of how much you're earning.

How does it work?

All the Payment Service functions are designed to make the user experience consistent for each type of payment and for every BlackBerry device. When a user wants to use your app to purchase digital goods, this is what happens:

BlackBerry Payment Service is a network that connects vendors and users to the BlackBerry World storefront through the Payment Service server. For paid apps, the Payment Service server also connects to payment providers that can process purchase payments. Vendors can also provide users with access to a content server hosting digital goods.



Content server

The content server is an optional component that you can set up to send digital goods to your users. If you include your digital goods in the source code for your app, and programmatically unlock the digital goods for users after a purchase, then you don't need this component.

If you set up a content server, you can provide the URL for the content server in the BlackBerry World vendor portal. The Payment Service server can use the URL to send notifications about successful purchases to your content server.

For more information about the content server, see Distributing digital goods.

Payment providers

The payment providers are the organizations that offer payment types that device users can use to purchase digital goods (for example, credit card, PayPal, carrier billing). The Payment Service server handles communications with the payment providers so that you don't have to implement support for each payment method in your app.

Payment Service server

The Payment Service server is the part of BlackBerry World that facilitates interactions between your app, the payment providers, the vendor portal, and your content server.

When a user wants to purchase your app, this is what happens:

  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 account, the Payment Service prompts the user to log in without leaving the 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, Payment Service provides the error code and your app handles the exception.

What's next?

Let's get started earning some money! Register your digital goods, learn about what the Payment Service has to offer, and use the code samples to create an app that includes some in-app purchasing.

Last modified: 2014-10-09

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

comments powered by Disqus