Cloudlink In App Purchase Overview – App47, Inc.

Introduction

The following page outlines what is required for an App Provider to incorporate the In App Purchase capability from Cloudlink.

Cloudlink In App Purchase

Overview and Purpose

In App Purchases for Cloudlink app providers allows the app provider to enable one time and subscription based purchases from within an app. Although some app providers may already provide this, the key value here is that using Cloudlink's API will facilitate using the same credit card information provided by the customer within the Cloudlink Toolbox. The customer will only be required to enter their Cloudlink Toolbox password. That is, there is a convenience factor at work – much like purchases on Amazon that are “one-click,” this API will enable “one-click-in-app-purchases.”

The goal of this API is to mimic Google Play's API Version 2, such that the app provider should only need to update the SKU definitions on the Cloudlink site and change the AndroidManifest.xml file to use the Cloudlink Toolbox API instead of Google Play.

In App Purchase Setup

Similar to the app setup, some information is needed for each item to be purchased from within the mobile App. By providing this information, Toolbox users can have account information (such as subscriptions) be available on various devices. This information will be added via a web interface associated with your app's account.

Name	Possible Values	Description	Localizable
Product Identifier	A 25 character string which cannot be null, that can contain the characters a-z, A-Z, 0-9, underscores, periods, and dashes	Unique identifiable value for you (the App Provider) to use within the application to uniquely identify the in app purchased item. This should match the same product identifier you use in Google Play.	No
Purchase type	One-time, monthly, quarterly, bi-annual, annual	Type of purchase, a one time purchase, or a renewable subscription based purchase.	No
Price	Value greater than $0	The USD value for this purchased item	Yes
Name	Any character, limited to 120 characters	Name of the purchased item.	Yes
Description	Any character, limited to 255 characters	Description of the purchased item.	Yes

Note: For localizable values, please provide the language and the translated value. Localizable here means that information will be displayed differently depending on the region in which the user resides.

Please see SKU Definition to understand how to configure your app for In App Purchase within toolbox.cloudlinkco.com web interface.

API Installation

The App provider will include a library provided by Cloudlink into their Android Mobile App. This library will provide all communication with the Toolbox App store already installed on the mobile device and the Cloudlink servers.

This library will handle a number of important aspects associated with purchases including:

customer password challenge and verification
payment processing
handling secure communication
managing subscriptions

Please see the Google Play Version 2 API as a basis for understanding how the API works.

Please see the App Modifications that are necessary to complete the installation.