Samsung In App Purchase v2.0 Programming Guide

Transcription

1 Samsung In App Purchase v2.0 Programming Guide

2 Revision History Version Description Author Date 1.0 Created Security-related content added Mode parameter added to getitemlist method Added IAP 2.0 restrictions, and upgrade checks and follow-up actions for getitemlist and Init() methods Added Codes Added data to check terms for short term subscriptions Added response code Added description on development mode,

3 Table of Contents 1 Samsung In App Purchase v IAP 2.0 Restrictions Product Purchase Product Type Creating an IAP Link Adding the IAP Library Adding Permissions Installing IAP and Authorizing Samsung Account Creating ServiceConnection and Binding IAPConnector Processing the IAP Request and Response with IAPConnector Development mode init() method getitemlist() method getitemsinbox() method Payment IAP Reference API Reference init method getitemlist method getitemsinbox method PaymentMethodListActivity Response Code... 27

4 1 Samsung In App Purchase v2.0 IAP (In-App Purchase) v2.0 lets you use Samsung s payment services inside apps. While v1.0 linked to the library jar file, v2.0 uses the AIDL (Android Interface Definition Language) to help the IAP process and applications communicate with each other. The latter makes it easier to link than the former. 1.1 IAP 2.0 Restrictions IAP is supported on Android API 10 and higher. It does not run properly on lower versions. It only runs on Samsung devices. There are no other restrictions. 1.2 Product Purchase The below figure shows the process where an application uses IAP to request the purchase of a product. 1 Proceed with the Samsung account authorization process. 2 Bind IAPConnector to enable the IAP API.

5 3 Call the init() method start resetting IAP and receive the results as a bundle. 4 Call the getitemlist() method to receive a list of purchasable products as a bundle. 5 Select a product to purchase and call the startactivityforresult() method to call an activity (PaymentMethodListActivity) for selecting a payment method. Then, receive the results as a bundle in the onactivityresult() method. 6 Call the getitemsinbox() method to receive a list of purchased products as a bundle. 7 When the entire process ends, unbind IAPConnector to finish using IAP. Note: You can use the product list without user authentication or resetting. This means the getitemlist() method does not require you to log in before you place products to sell in apps. 1.3 Product Type IAP supports the following product types. Type Consumable Product Non-Consumable Product Subscription (short-term product) All Description If you purchase and use this type of product, it is consumed. You need to repurchase it to use it again. * e.g. Consumable products such as bullets in games. If you purchase this type of product, you can keep using it permanently. You cannot repurchase it. * e.g. Non-consumable products such as a book that you do not have to purchase again. Products that you can repurchase after a certain period of time. * e.g. Products such as monthly magazines and short-term passes that can be repurchased after a certain time. All of the three types above are included.

6 2 Creating an IAP Link In order to use the IAP payment service in an application, you must follow the steps below. 1 Add the IAP library. 2 Add permissions. 3 Install IAP and authorize your Samsung account. 4 Create a ServiceConnection and bind it to IAPConnector. 5 In the application, request IAP with IAPConnector and process the response. 2.1 Adding the IAP Library The 'IAPConnector.aidl' and 'IAPServiceCallback.aidl' files are AIDL (Android Interface Definition Language) files with the IAP interfaces defined. They use the IPC (Inter-Process Communication) method to provide interfaces for linking with the IAP process. In order to link with IAP, add these files to your application projects as below. If you use Eclipse: Step 1) Create a package with the name 'com.sec.android.iap' under the src folder of the application project that will use IAP. Step 2) Copy the 'IAPConnector.aidl' and 'IAPServiceCallBack.aidl' files under the 'com.sec.android.iap' package. If you do not use Eclipse: Step 1) Create a folder with the structure 'src/com/sec/android/iap'. Step 2) Copy the files 'IAPConnector.aidl' and 'IAPServiceCallBack.aidl' in the new folder. Step 3) Use the Ant tool to build a project and create the 'IAPConnector.java' and 'IAPServiceCallback.java' files. Through the process above, create the 'IAPConnector.java' and 'IAPServiceCallback.java' files that were created in the application project '/gen' folder. 2.2 Adding Permissions In order to use IAP, you must register the "com.sec.android.iap.permission.billing" permission in the AndroidManifest.xml file. Add the permission to AndroidManifest.xml as below. <uses-permission android:name="com.sec.android.iap.permission.billing"/>! If you do not register the permission, it will always fail in the next step, the Samsung account authorization process

7 2.3 Installing IAP and Authorizing Samsung Account Checking IAP installation public boolean isinstallediappackage( Context _context ) PackageManager pm = _context.getpackagemanager(); try pm.getapplicationinfo( "com.sec.android.iap", PackageManager.GET_META_DATA ); return true; catch( NameNotFoundException e ) e.printstacktrace(); return false; If the flag value in the above code is true, it means that IAP is already installed. If it is false, it means IAP is not installed. If IAP is installed: Test the validity of the installed IAP by comparing the signature hash codes of the IAP package. private static final int IAP_SIGNATURE_HASHCODE = 0x7a7eaf4b; public boolean isvalidiappackage( Context _context ) boolean result = true; try Signature[] signs = getpackagemanager().getpackageinfo( "com.sec.android.iap" PackageManager.GET_SIGNATURES ).signatures; if( sigs[0].hashcode()!= IAP_SIGNATURE_HASHCODE ) result = false; catch( Exception e ) e.printstacktrace(); result = false; return result;

8 If the validity test of the installed IAP reveals that the IAP is not valid, a message dialog must be displayed as shown below, and the payment process must not proceed any further. // If the installed IAP package is not valid: // ================================================================ if( false == isvalidiappackage( _activity ) ) new AlertDialog.Builder( _activity ).settitle( R.string.in_app_purchase ).setmessage( R.string.invalid_iap_package ).setpositivebutton( android.r.string.ok, new public void onclick( DialogInterface dialog, int which ) dialog.dismiss(); _activity.finish(); ).show(); // ================================================================ If the installed IAP is valid, proceed with the Samsung account authorization process as below. You can move on to the next step if the account is successfully authorized. // If the installed package is valid: // ================================================================ else ComponentName com = new ComponentName( "com.sec.android.iap", "com.sec.android.iap.activity.accountactivity" ); Intent intent = new Intent(); intent.setcomponent( com ); startactivityforresult( intent, 1001 ); // ================================================================ Call the IAP AccountActivity to authorize the Samsung account. AccountActivity is used to authorize your Samsung account and reconfirm your password when you make a payment. When you call AccountActivity, the application uses the startactivityforresult method to call it, and IAP returns the Samsung account authorization results to the onactivityresult method in the application. onactivityresult protected void onactivityresult(int _requestcode, int _resultcode, Intent _intent) if( _requestcode == 1001 ) if( _resultcode == RESULT_OK ) /* Login successful */

9 If IAP is not installed: To install IAP, go to the IAP details page at Samsung Apps. static final int FLAG_INCLUDE_STOPPED_PACKAGES = 32; Intent intent = new Intent(); intent.setdata( Uri.parse( "samsungapps://productdetail/com.sec.android.iap" ) ); // For Honeycomb MR1 or higher, add the FLAG_INCLUDE_STOPPED_PACKAGES flag. if( Build.VERSION.SDK_INT >= 12 ) intent.addflags( Intent.FLAG_ACTIVITY_NEW_TASK Intent.FLAG_ACTIVITY_CLEAR_TOP FLAG_INCLUDE_STOPPED_PACKAGES ); else intent.addflags( Intent.FLAG_ACTIVITY_NEW_TASK Intent.FLAG_ACTIVITY_CLEAR_TOP ); startactivity( intent ); 2.4 Creating ServiceConnection and Binding IAPConnector To communicate with IAP in applications, you must create a ServiceConnection. Please follow the steps below. 1 Binding IAPConnector 2 Unbinding When Closing an Application 1 Binding IAPConnector To connect to IAP in applications, implement ServiceConnection in an Activity and bind IAPConnector. After creating ServiceConnection, use the overridden methods onservicedisconnected and onserviceconnected to refer to IAPConnector instances. IAPConnector miapconnector; ServiceConnection mserviceconn = new public void onservicedisconnected( ComponentName name ) miapconnector = null; public void onserviceconnected( ComponentName name, IBinder service ) miapconnector = IAPConnector.Stub.asInterface( service );

10 Bind using the bindservice method that has the intent that is referred to for IAP service names and created ServiceConnection objects as parameters. Intent serviceintent = new Intent( "com.sec.android.iap.service.iapservice" ); bindservice( serviceintent, mserviceconn, Context.BIND_AUTO_CREATE ); When you complete the process above, you can use miapconnector to communicate with IAP. 2 Unbinding When Closing an Application You must unbind IAP when closing applications. If IAP is no longer needed, you must unbind the mserviceconn Service Connection object.. unbindservice( mserviceconn ); 2.5 Processing the IAP Request and Response with IAPConnector IAP provides the interfaces below. Type Name Description Method init Setting and resetting of information for using payment services. Method getitemlist List of products. Method getitemsinbox List of purchased products. Activity PaymentMethodListActivity Activity for selecting a payment method and requesting payment. Each interface is described in detail below. Development mode Testing of the payment service is not easy due to fee charging. So, IAP supports a developer mode which allows testing in various situations. Each interface provided by IAP has a mode parameter in the form of an integer. You can set development mode by changing this value. The below are the modes supported by IAP. Mode Value Description Live (production) mode 0 This is the mode for production. When releasing your app, you must use this mode. Actual payment occurs only in production mode. Test mode (success) 1 This test mode always returns successful results. Test mode (failure) -1 This test mode always returns failed results. During development, you should test your app in various situations by setting the value to 1 and -1

11 which will always return successful and failed results respectively. Before releasing your app, however, you must change the mode to production mode. If you release your app in test mode, no payment will occur. There have been cases where developers released their apps in developer mode. So, we implemented a pop-up window that notifies you if developer mode is in use. If you see this message, please check your mode. Each interface is described in detail below. 1 init() method This must be called before you use any IAP services, including 'List of products', 'List of purchased products', and 'Payment'. After the Samsung account is successfully authorized, call the init() method to set basic required payment information. The init() method sets up the following basic information to use in IAP: IAP upgrade check, server URL, country code, shop ID, currency (currency unit) information, user ID, and .

12 Note: If you call the init() method on the main thread, an ANR (Application Not Responding) might occur. Create a separate thread to avoid the error. Bundle bundle = miapconnector.init( mmode ); if ( null!= bundle ) int statuscode = bundle.getint( "STATUS_CODE" ); String errorstring = bundle.getstring( "ERROR_STRING" ); // The address of the destination page is delivered with the IAP_UPGRADE_URL keyword when statuscode is String extrastring = bundle.getstring( "IAP_UPGRADE_URL" ); if ( statuscode == 0 ) /* If initialization is successful */ if ( statuscode == ) /* IAP Package Upgrade Process when needed. */ // Display a pop-up window about upgrades. When the user clicks OK, direct the user to the Samsung Apps IAP page. new AlertDialog.Builder( this ).settitle("iap Upgrade" ).setmessage( errorstring ).setpositivebutton( android.r.string.ok, new public void onclick( DialogInterface dialog, int which ) Intent intent = new Intent(); intent.setdata( Uri.parse( extrastring ) ); intent.addflags( Intent.FLAG_ACTIVITY_NEW_TASK ); try ).show(); startactivity( intent ); catch( ActivityNotFoundException e ) e.printstacktrace(); If 'STATUS_CODE' is '0', the initial setup has successfully completed and you can use the services, including 'List of products', 'List of purchased products', and 'Payment'. Note: If statuscode is in the sample code above, the IAP package needs to be updated. If it does not get updated, you cannot use IAP. Therefore, you must add the process that encourages updating through the IAP page of Samsung Apps.

13 2 getitemlist() method This returns the List of purchasable products as a bundle. Note: If you call the getitemlist() method on the main thread, an ANR (Application Not Responding) might occur. Create a separate thread to avoid the error. Bundle bundle = miapconnector.getitemlist( mmode, getpackagename(), _itemgroupid, _startnum, _endnum, _itemtype ); Information about whether the request was successful or not is saved in 'STATUS_CODE', the key value of the returned bundle. (If successful, '0'.) If STAUS_CODE is -1001, the IAP package needs to be updated. Please refer to the earlier part about how to process the results of the init() method sample code. Using RESULT_LIST inside a Bundle int statuscode = bundle.getint( "STATUS_CODE" ); if ( statuscode == 0 ) ArrayList<String> arraylist = bundle.getstringarraylist( "RESULT_LIST" ); for( String itemstring : arraylist ) JSONObject jobject = new JSONObject( itemstring ); String itemid = jobject.getstring( "mitemid" ); String itemname = jobject.getstring( "mitemname" ); String itemprice = jobject.getstring( "mitemprice" ); String currencyunit = jobject.getstring( "mcurrencyunit" ); String itemdesc = jobject.getstring( " mitemdesc" ); String itemimageurl = jobject.getstring( "mitemimageurl" ); String itemdownloadurl = jobject.getstring( "mitemdownloadurl" ); String reserved1 = jobject.getstring( "mreserved1" ); String reserved2 = jobject.getstring( "mreserved2" ); String type = jobject.getstring( "mtype" ); 3 getitemsinbox() method This returns the List of purchased products as a bundle. Note: If you call the getitemsinbox() method on the main thread, an ANR (Application Not Responding) might occur. Create a separate thread to avoid the error. Bundle itemsinboxlist = miapconnector.getitemsinbox( mcontext.getpackagename(), _itemgroupid, _startnum, _endnum, _startdate, _enddate ); Information about whether the request was successful or not is saved in 'STATUS_CODE', the key value of the returned bundle. (If successful, '0'.)

14 Using RESULT_LIST inside a Bundle int statuscode = bundle.getint( "STATUS_CODE" ); if ( statuscode == 0 ) ArrayList<String> arraylist = bundle.getstringarraylist( " RESULT_LIST" ); for ( String itemstring : arraylist) JSONObject jobject = new JSONObject( itemstring ); String itemid = jobject.getstring( "mitemid" ); String itemname = jobject.getstring( "mitemname" ); String itemdesc = jobject.getstring( " mitemdesc " ); String itemprice = jobject.getstring( "mitemprice" ); String currencyunit = jobject.getstring( " mcurrencyunit " ); String itemimageurl = jobject.getstring( " mitemimageurl " ); String itemdownloadurl = jobject.getstring( " mitemdownloadurl " ); String purchasedate = jobject.getstring( " mpurchasedate " ); long timeinmillis = Long.parseLong( jobject.getstring( "mpurchasedate" ) ); String paymentid = jobject.getstring( "mpaymentid" ); String reserved1 = jobject.getstring( "mreserved1" ); String reserved2 = jobject.getstring( "mreserved2" ); String type = jobject.getstring( "mtype" ); String itempricestring = jobject.getstring( "mitempricestring" ); 4 Payment Make the process so that you can go to the IAP Payment Activity where you can pay for a product. Bundle bundle = new Bundle(); bundle.putstring( "THIRD_PARTY_NAME", getpackagename() ); bundle.putstring( "ITEM_GROUP_ID", _itemgroupid ); bundle.putstring( "ITEM_ID", _itemid ); ComponentName com = new ComponentName( "com.sec.android.iap", "com.sec.android.iap.activity.paymentmethodlistactivity" ); Intent intent = new Intent( Intent.ACTION_MAIN ); intent.addcategory( Intent.CATEGORY_LAUNCHER ); intent.setcomponent( com ); intent.putextras( bundle ); startactivityforresult( intent, 1000 ); When you call the IAP Payment Details Activity, the application uses the startactivityforresult method to call it, and IAP returns the payment results in the application s onactivityresult method. onactivityresult method Data for the payment intent s 'RESULT_OBJECT' key is returned as a JSON string as illustrated below.

15 "mitemdesc":"learn about the books of the Bible##46;", "mcurrencyunit":" ", "mitemimageurl":" _NEW_WEB_ICON.png", "mitemdownloadurl":"", "mpaymentid":"zpmtid gbi ", "mitemprice":1, "mverifyurl":" ", "mitemname":"books", "mpurchasedate": , "mpurchaseid":" a3a cbe35bf033f59bcb6f9ec79a950ab5d83de67b3ff92f8", "mreserved1":"", "mreserved2":"", "mitemid":" ", "mitempricestring":" 1.00" You can get a desired value by creating a JSON object as below. Additional values such as STATUS_CODE, THIRD_PARTY_NAME, ERROR_STRING and ITEM_ID are included in the bundle. // 1. Processing IAP payment results: // treat result of IAPService // ============================================================================ if( _requestcode == 1 ) if( null == _intent ) return; Bundle extras = _intent.getextras(); String itemid = ""; String thirdpartyname = ""; // payment success : 0 // payment cancelled : 1 // ======================================================================== int statuscode = 1; // ======================================================================== String errorstring = ""; String purchasedata = ""; // 1) If there is bundle information transferred from IAP: // if( null!= extras ) thirdpartyname = extras.getstring( "THIRD_PARTY_NAME" ); statuscode = extras.getint( "STATUS_CODE" ); errorstring = extras.getstring( "ERROR_STRING" ); itemid = extras.getstring( "ITEM_ID" ); purchasedata = extras.getstring( "RESULT_OBJECT" ); // // 2) If there is no bundle information transferred from the IAP:

16 // else showresultdialog( getstring( R.string.dlg_title_payment_error ), getstring( R.string.msg_payment_was_not_processed_successfully ) ); // // 3) If payment is not cancelled: // If payment was not cancelled // if( RESULT_OK == _resultcode ) try JSONObject jobject = new JSONObject( purchasedata ); String paymentid = jobject.getstring( "mpaymentid" ); String itemdesc = jobject.getstring( "mitemdesc" ); String itemprice = jobject.getstring( "mitemprice" ); String currencyunit = jobject.getstring( "mcurrencyunit" ); String itemimageurl = jobject.getstring( "mitemimageurl" ); String itemname = jobject.getstring( "mitemname" ); String purchasedate = jobject.getstring( "mpurchasedate" ); long timeinmillis = Long.parseLong( jobject.getstring("mpurchasedate") ); String purchaseid = jobject.getstring( "mpurchaseid" ); String reserved1 = jobject.getstring( "mreserved1" ); String reserved2 = jobject.getstring( "mreserved2" ); String itemdownloadurl = jobject.getstring( "mitemdownloadurl" ); itemid = jobject.getstring( "mitemid" ); String itempricestring = jobject.getstring( "mitempricestring" ); String verifyurl = jobject.getstring( "mverifyurl" ); // a. If the payment result is success: // if( statuscode == 0 ) String serverurl = verifyurl + "&purchaseid=" + purchaseid; new VerifyClientToServer( serverurl, purchaseid, paymentid ).execute(); // b. If the payment result is failure: // else showresultdialog( getstring( R.string.dlg_title_payment_error ), "-itemid : " + itemid + "\n-thirdpartyname : " + thirdpartyname + "\n-statuscode : " + statuscode + "\n-errorstring : " + errorstring ); // catch( JSONException e ) e.printstacktrace(); //

17 // 4) If payment is canceled: // If payment was cancelled // else if( RESULT_CANCELED == _resultcode ) showresultdialog( getstring( R.string.dlg_title_payment_cancelled ), "-itemid : " + itemid + "\n-thirdpartyname : " + thirdpartyname + "\n-statuscode : " + statuscode ); // // ============================================================================ In order to prevent problems caused by sniffing apps during payment result processing, use the mverifyurl and mpurchaseid values in the bundle that came as a result, to check if the payment is valid for the IAP server. For that purpose, VerifyClientToServer AsyncTask is run in the above example. Below is source code for VerifyClientToServer AsyncTask. private class VerifyClientToServer extends AsyncTask<Void, Void, Boolean> String mserverurl = null; String mpurchaseid = null; String mpaymentid = null; VerificationVO mverificationvo = null; public VerifyClientToServer ( String _strurl, String _purchaseid, String _paymentid ) mserverurl = _strurl; mpurchaseid = _purchaseid; mpaymentid = protected void onpreexecute() super.onpreexecute(); // Cancel the task if the server URL, mpurchasedid and mpaymentid are empty // ================================================================ if( true == TextUtils.isEmpty( mserverurl ) true == TextUtils.isEmpty( mpurchaseid ) true == TextUtils.isEmpty( mpaymentid) ) this.cancel( true ); // ================================================================ mprogressdialog = showprogressdialog( ItemList.this protected void oncancelled() dismissprogressdialog( mprogressdialog );

18 protected Boolean doinbackground( Void... params ) try int retrycount = 0; String strresponse = null; // For reliability, if an error occurs, retry up to 3 times. // ============================================================= do strresponse = gethttpgetdata( mserverurl, 10000, ); retrycount++; while( retrycount < 3 && true == TextUtils.isEmpty( strresponse ) ); // ============================================================= if( strresponse == null TextUtils.isEmpty( strresponse ) ) return false; else mverificationvo = new VerificationVO( strresponse ); // Only if Status Code is "true", and if PaymentId and // mpaymentid of mverificationvo match, determine as success. // ========================================================== if( mverificationvo!= null && true == "true".equals( mverificationvo.getmstatus() ) && true == mpaymentid.equals( mverificationvo.getmpaymentid() ) ) return true; // ========================================================== else return false; catch( Exception e ) e.printstacktrace(); return protected void onpostexecute( Boolean result ) dismissprogressdialog( mprogressdialog ); if( true == result ) showresultdialog(

19 getstring( R.string.dlg_title_payment_success ), "-itemid : " + mverificationvo.getmitemid() + "\n-paymentid : " + mverificationvo.getmpaymentid() ); else showresultdialog( getstring( R.string.dlg_title_payment_error ), getstring( R.string.msg_invalid_purchase ) ); private String gethttpgetdata ( final String _strurl, final int _conntimeout, ) final int _readtimeout String strresult = null; URLConnection con = null; HttpURLConnection httpconnection = null; BufferedInputStream bis = null; ByteArrayOutputStream buffer = null; try URL url = new URL( _strurl ); con = url.openconnection(); con.setconnecttimeout(10000); con.setreadtimeout(10000); httpconnection = (HttpURLConnection)con; httpconnection.setrequestmethod("get"); httpconnection.connect(); int responsecode = httpconnection.getresponsecode(); if( responsecode == 200 ) bis = new BufferedInputStream( buffer = new ByteArrayOutputStream( 4096 ); byte [] bdata = new byte[ 4096 ]; int nread; httpconnection.getinputstream(), 4096 ); while( ( nread = bis.read( bdata, 0, 4096 ) )!= -1 ) buffer.write( bdata, 0, nread ); buffer.flush(); strresult = buffer.tostring(); catch( Exception e ) e.printstacktrace(); finally if( bis!= null )

20 try bis.close(); catch (Exception e) if( buffer!= null ) try buffer.close(); catch (IOException e) con = null; httpconnection = null; return strresult; In the VerifyClientToServer example above, strresponse is JSON formatted as shown below. "itemid":" ", "itemname":"additional Game Modes", "itemdesc":"unlock all game modes. Best value!", "purchasedate":" :04:50", "paymentid":"zpmtid gbi ", "paymentamount":"1.500", "status":"true" You can receive strresponse from the server and extract a desired value, such as the creator of the verification class below. The example below is part of the VerificationVO source used as an object for saving task results in VerifyClientToServer AsyncTask. public class VerificationVO private String mitemid; private String mitemname; private String mitemdesc; private String mpurchasedate; private String mpaymentid; private String mpaymentamount; private String mstatus; public VerificationVO( String strjson ) try JSONObject jobject = new JSONObject( strjson ); mitemid = jobject.getstring( "itemid" ); mitemname = jobject.getstring( "itemname" ); mitemdesc = jobject.getstring( "itemdesc" ); mpurchasedate = jobject.getstring( "purchasedate" ); mpaymentid = jobject.getstring( "paymentid" ); mpaymentamount = jobject.getstring( "paymentamount" ); mstatus = jobject.getstring( "status" );

21 catch( JSONException e ) e.printstacktrace(); Omitted For safer transactions, it is recommended that you process tasks such as VerifyClientToServer in the above sample code through a 3 rd -party server. 3 IAP Reference This chapter provides reference information to use IAP. 3.1 API Reference This is the API defined in the 'IAPConnector.java' and 'IAPServiceCallback.java' files. 1 init method init( int mode ) This method must be called before you use IAP services, including 'List of products', 'List of purchased products', and 'Payment Details'. It returns results as a bundle. - Parameter details Parameter Type Description mode int Value for IAP mode 0: Live (production) mode 1: Development mode (returned results are true every time) -1: Development mode (returned results are false every time) - Key descriptions for returned bundle Parameter Description STATUS_CODE ERROR_STRING IAP_UPGRADE_URL Result code (If not 0, error or failure) Message in case of an error or failure URI information to navigate to the IAP package upgrade page (STATUS_CODE == -1001) at Samsung Apps when an upgrade is needed

22 - STATUS_CODE types for result bundle Response code Code value Description IAP_ERROR_NONE 0 Successful IAP_ERROR_INITIALIZATION Failure while resetting IAP IAP_ERROR_NEED_APP_UPGRADE IAP upgrade required IAP_ERROR_COMMON Error while running IAP IAP_ERROR_NETWORK_NOT_AVAILABLE Network not available IAP_ERROR_IOEXCEPTION_ERROR IO exception IAP_ERROR_SOCKET_TIMEOUT Socket timeout exception IAP_ERROR_CONNECT_TIMEOUT Connection timeout exception 2 getitemlist method getitemlist(string packagename, String itemgroupid, int startnum, int endnum, String itemtype ) This method returns the List of purchasable products as a bundle. - Parameter details Parameter Type Description mode int Value for IAP mode 0: Live (production) mode 1: Development mode (returned results are true every time) -1: Development mode (returned results are false every time) packagename String Package name of the application itemgroupid String Group ID of the product startnum int Starting number of the list to be shown endnum int Ending number of the list to be shown itemtype String Item type Consumable: 00 Non-consumable: 01 Subscription (short-term): 02 All: 10 - Key descriptions for returned bundle Parameter Description STATUS_CODE ERROR_STRING IAP_UPGRADE_URL RESULT_LIST Result code (If not 0, error or failure) Message in case of an error or failure URI information to navigate to the IAP package upgrade page (STATUS_CODE == -1001) at Samsung Apps when an upgrade is needed Product list as a JSON string

23 - STATUS_CODE types for result bundle Response code Code value Description IAP_ERROR_NONE 0 Successful IAP_ERROR_COMMON Error while running IAP IAP_ERROR_PRODUCT_DOES_NOT_E XIST IAP_ERROR_ITEM_GROUP_DOES_NOT_E XIST No product list requested No item group ID IAP_ERROR_NETWORK_NOT_AVAILABLE Network not available IAP_ERROR_IOEXCEPTION_ERROR IO exception IAP_ERROR_SOCKET_TIMEOUT Socket timeout exception IAP_ERROR_CONNECT_TIMEOUT Connection timeout exception - JSON field description for Bundle 'RESULT_LIST' Parameter Description mitemid mitemname mitemprice mcurrencyunit mitemdesc mitemimageurl mitemdownloadurl mitempricestring Product ID Product name Product price Currency Product description Product image URL Product download URL Currency + product price string mreserved1 Reserved 1 mreserved2 Reserved 2 mtype msubscriptiondurationunit msubscriptiondurationmultiplier Product type If the product type is a subscription, YEAR, MONTH, WEEK, and DAY are provided as subscription period units in capital letters. This is the product duration if the product type is a subscription. Combined with msubscriptiondurationunit, it is expressed as 1MONTH.

24 3 getitemsinbox method getitemsinbox(string packagename, String itemgroupid, int startnum, int endnum, String startdate, String enddate) method This method returns the List of purchased products as a bundle. - Parameter details Parameter Type Description packagename String Package name of the application itemgroupid String Group ID of the product startnum int Starting number of the list to be shown endnum int Ending number of the list to be shown startdate String Start date of the purchase period (e.g ) enddate String End date of the purchase period (e.g ) - Key descriptions for returned bundle Parameter Description STATUS_CODE ERROR_STRING RESULT_LIST Result code (If not 0, error or failure) Message in case of an error or failure Purchased product list as a JSON string - STATUS_CODE types for result bundle Response code Code value Description IAP_ERROR_NONE 0 Successful IAP_ERROR_COMMON Error while running IAP IAP_ERROR_ITEM_GROUP_DOES_NOT_EXIST No item group ID IAP_ERROR_NETWORK_NOT_AVAILABLE Network not available IAP_ERROR_IOEXCEPTION_ERROR IO exception IAP_ERROR_SOCKET_TIMEOUT Socket timeout exception IAP_ERROR_CONNECT_TIMEOUT Connection timeout exception

25 - JSON field description for Bundle 'RESULT_LIST' Parameter Description mitemid mitemname mitemprice mitempricestring mitemdesc mcurrencyunit mpurchasedate mpaymentid mpurchaseid mitemimageurl mitemdownloadurl Product ID Product name Product price Currency + product price Product description Currency Purchase date (in milliseconds) Payment ID Purchase ID Product image URL Product download URL mreserved1 Reserved 1 mreserved2 Reserved 2 mtype msubscriptionenddate Product type This is the product expiration date for subscription products. It is returned as a long type. 4 PaymentMethodListActivity This section explains the required bundle information and results that are delivered when the IAP payment feature is used. - Required bundle information at the time of request Parameter Type Description packagename String Package name of the application itemgroupid String Group ID of the product itemid String Product ID - Key descriptions for returned bundle Parameter Description STATUS_CODE ERROR_STRING RESULT_OBJECT ITEM_ID Result code (If not 0, error or failure) Message in case of an error or failure Payment result as a JSON string ID of the product to purchase

26 - STATUS_CODE types for result bundle Response code Code value Description IAP_ERROR_NONE 0 Successful IAP_PAYMENT_IS_CANCELED 1 Payment canceled IAP_ERROR_COMMON Error while running IAP IAP_ERROR_ALREADY_PURCHASED IAP_ERROR_WHILE_RUNNING The product is a non-consumable product and cannot be repurchased Called payment details without bundle information IAP_ERROR_PRODUCT_DOES_NOT_EXIST No product requested IAP_ERROR_CONFIRM_INBOX IAP_ERROR_ITEM_GROUP_DOES_NOT_E XIST The payment results were not successful, but the list of purchased products needs to be checked because the product could have been purchased No item group ID IAP_ERROR_NETWORK_NOT_AVAILABLE Network not available IAP_ERROR_IOEXCEPTION_ERROR IO exception IAP_ERROR_SOCKET_TIMEOUT Socket timeout exception IAP_ERROR_CONNECT_TIMEOUT Connection timeout exception - JSON field description for Bundle 'RESULT_OBJECT' Parameter Description mitemid mitemname mitemdesc mitemprice mitempricestring mcurrencyunit mpaymentid mpurchasedate mpurchaseid Product ID Product name Product description Product price Product price with currency Currency Payment ID Purchase date (in milliseconds) Purchase ID mreserved1 Reserved 1 mreserved2 Reserved 2 mitemimageurl mitemdownloadurl mverifyurl Product image URL Product download URL IAP server URL for checking if the purchase is valid for the IAP server, using the mpurchaseid value

27 3.2 Response Code The below is a list of codes for 'STATUS_CODE', the key value of the bundle returned from IAP. Response code Code value Description IAP_ERROR_NONE 0 Successful IAP_PAYMENT_IS_CANCELED 1 Payment canceled IAP_ERROR_INITIALIZATION Failure while resetting IAP IAP_ERROR_NEED_APP_UPGRADE IAP upgrade required IAP_ERROR_COMMON Error while running IAP IAP_ERROR_ALREADY_PURCHASED A non-consumable product is repurchased, or a subscription product is repurchased before it expires IAP_ERROR_WHILE_RUNNING IAP_ERROR_PRODUCT_DOES_NOT_E XIST Payment details (PaymentMethodListActivity) are called without any bundle information No product list requested IAP_ERROR_CONFIRM_INBOX No results were received after a payment request made to the server. Consequently, a list of purchased products must be checked because the payment may have been successful. IAP_ERROR_ITEM_GROUP_DOES_NOT_E XIST No item group ID IAP_ERROR_NETWORK_NOT_AVAILABLE Network not available IAP_ERROR_IOEXCEPTION_ERROR IO exception IAP_ERROR_SOCKET_TIMEOUT Socket timeout exception IAP_ERROR_CONNECT_TIMEOUT Connection timeout exception