Samsung In-App Purchase v3.0 Development Preparationsdeveloper.samsung.com/html/techdoc/HowToStart_SamsungInAppPu… · This document describes how to use Samsung In-App Purchase

Samsung In-App Purchase v3.0

Development Preparations

Copyright © Samsung Electronics Co., Ltd. All rights reserved. Page 2

Copyright Copyright © 2015 Samsung Electronics Co. Ltd. All Rights Reserved.

Though every care has been taken to ensure the accuracy of this document, Samsung Electronics Co., Ltd. cannot accept responsibility for any errors or omissions or for any loss occurred to any person, whether legal or natural, from acting, or refraining from action, as a result of the information contained herein. Information in this document is subject to change at any time without obligation to notify any person of such changes.

Samsung Electronics Co. Ltd. may have patents or patent pending applications, trademarks copyrights or other intellectual property rights covering subject matter in this document. The furnishing of this document does not give the recipient or reader any license to these patents, trademarks copyrights or other intellectual property rights.

No part of this document may be communicated, distributed, reproduced or transmitted in any form or by any means, electronic or mechanical or otherwise, for any purpose, without the prior written permission of Samsung Electronics Co. Ltd.

The document is subject to revision without further notice.

All brand names and product names mentioned in this document are trademarks or registered trademarks of their respective owners.

For more information, please visit http://developer.samsung.com/

http://developer.samsung.com/


Table of Contents

Copyright .............................................................................................................................................................................. 2

1. Scope and Purpose ...................................................................................................................................................... 4

2. Getting Started .............................................................................................................................................................. 4

2.1. Joining the Samsung Seller Site ................................................................................................................. 5

2.2. Registering Apps ............................................................................................................................................. 5

2.3. Registering Items ............................................................................................................................................ 6

2.4. Changing to Being a Commercial Seller ................................................................................................. 6

3. IAP3.0 Development ................................................................................................................................................... 8

3.1. Adding Items..................................................................................................................................................... 9

3.2. Modifying Item Info .................................................................................................................................... 10

3.3. Adding Payment Method for a Registered App Item ..................................................................... 11

3.3.1. SDK for Android ........................................................................................................................................ 11

3.3.2. SDK for Adobe Air .................................................................................................................................... 11

4. Miscellaneous ............................................................................................................................................................. 12

4.1. Viewing Item Sales Volume Statistics .................................................................................................. 12


1. Scope and Purpose

This document describes how to use Samsung In-App Purchase in your apps. It provides guidance and samples for reference. This document covers everything starting from In-App Purchase to managing sales to help reduce any trial and error mistakes.

2. Getting Started

The Samsung Seller site is where In-App Purchase items are registered and managed, in addition to registering and managing apps in Samsung Galaxy Apps. This guide shows how to register apps and In-App Purchase items, become a paid seller, and view statistics.

You can access this guide by clicking “Guide” in the top-right corner of the screen, as shown below. All guides related to the Samsung Seller site are located in the “Guide” drop-down menu.

Figure 1: Samsung Galaxy Apps Seller Office Guide Menu


2.1. Joining the Samsung Seller Site

Once you have decided to create an app with In-App Purchase, you need to register an account in the Samsung Seller site. If this is not your first app, then you can also use your existing account. Click “Join Now” in the top-right corner of the http://seller.samsungapps.com site to create an account.

Figure 2: Registering as a Seller

After creating an account by following the instructions shown, you are redirected back to the first page to login to the site.

2.2. Registering Apps

The In-App Purchase service helps you sell items through your app. In order for actual sales to proceed, the app must be registered on the Samsung Seller site beforehand. But if you are in the development stages with In-App Purchase or only need to test, you may register items without the app being registered. If you are registering for testing or is in the middle of developing an app that is not ready for registration, you may skip the following step which describes how to register items.

http://seller.samsungapps.com/


2.3. Registering Items

Items must be registered in order to use In-App Purchase.

All item information except for the item type and item ID can be changed later, so be sure to select the correct type and ID at the beginning.

It is easy to overlook item images while registering items. The image is shown before the user makes a payment to make sure the user knows what item is being paid for. It is important that this image is consistent with the item image in the app to avoid any confusion.

2.4. Changing to Being a Commercial Seller

In order for any app or item to be sold, you must identify yourself according to e-commerce laws. The Samsung Seller site provides a simple way to become a paid seller for your convenience. You need to verify your identification and information on how to receive your profits.

Figure 3: Request Commercial Seller Status Button


Besides your personal information, you will also need to provide bank account information, or PayPal. You will also need to submit the following documents:

A copy of your Passport or ID Card

Proof of bank account

Figure 4: Seller Identity and Bank Info

For more information on what kinds of documents are acceptable, click on the help icon:


3. IAP3.0 Development

You can add, modify, and delete an Item as shown below.

Figure 5: List of Items for In-App Purchase


3.1. Adding Items

You can add a new Item by clicking Add Item and add item information in the following screen. The Item ID value is used to purchase the item.

Figure 6: "Add Item" Screen


3.2. Modifying Item Info

Title, Description, Price, and other information about the item information can be modified. Modifying is the same as when the items were first registered. Click the item name to modify and the following pop-up will appear. Item ID and Item Type cannot be modified. If you registered any item with the wrong item type or ID, you can delete it and add a new item.

Figure 7: "Update Item" Screen Populated

Any edits will be applied immediately, so check your edit before applying it. However, if a user is in the middle of a payment, then the edit will only appear to the user 30 seconds after it is entered.


3.3. Adding Payment Method for a Registered App Item

Once items for sale are ready in the Samsung Seller site, you need to add purchase logic to your app. Samsung IAP provides a simple and easy way to add purchase logic with the IAP Helper.

Depending on how your app was developed, choose one of the three methods below to use the In-App Purchase service in your app. All SDKs below are open source. Documentation on how to use these SDKs is also publicly available. Use the SDKs to easily add or test a payment module. The following SDKs are relevant for most cases.

3.3.1. SDK for Android

This is the universal SDK for implementing In-App Purchase services in Android apps. This SDK uses AIDL (Android Interface Definition Language) for communication.

NOTE: Download and refer to the latest document version of the following guide from the IAP section of the Samsung Developers site.

e_SamsungInAppPurchaseSDK_v3.0.0

3.3.2. SDK for Adobe Air

The SDK for In-App Purchase services in Android apps that use Adobe Air. This SDK is provided as an ANE (Air Native Extension) and was developed based on the In-App Purchase SDK for Android.

NOTE: Download and refer to the latest document version of the following guide from the IAP section of the Samsung Developers site.

IAP2.0_Lib_AdobeAir_Programming_Guide


4. Miscellaneous

4.1. Viewing Item Sales Volume Statistics

Understanding the flow of your item sales volume allows you to predict user tendency and modify item prices, variety, and more. This also allows you to hold events. Real-time modifications to item prices, descriptions, images, and more will not only boost sales, but can strategically help increase profit.

The sales volume of your items can be viewed in Samsung Seller from the

Statistics Item menu. Use filters such as Dimension and Period for an advanced statistics search. You can also export results in an Excel format.

Figure 8: Statistics Parameters for your App

Documents

Samsung In-App Purchase v3.0 Development Preparationsdeveloper.samsung.com/html/techdoc/HowToStart_SamsungInAppPu… · This document describes how to use Samsung In-App Purchase