Version 1.4. Samsung Smart TV In-App Billing Integration Guide

Transcription

1 Samsung Smart TV In-App Billing Integration Guide October

2 Revision History Version Date Description Merge DPI & Samsung Checkout on TV. Rearrange the document. Update example code. * Update: Flow, Sequence, 3 API Guide Modify minor bug. * Update: 3 API Guide Modify minor bug. Add product type Paid App * Update: Registration of Individual Product, Request Purchases List, Request Products List Modify example code (when submit the app) * Update: All example code of 3 API Guide Add DPI Product Type Overview. Add how to refund and check in application. Add DPI API Subscription Cancel [POST] Add restrictions about saving data inside TV. * Update: [DPI Product Type Overview], Refund, Subscription Cancel [POST], [Appendix 2] 2

3 [ CONTENTS ] [ CONTENTS ]... 3 [ Glossary ]... 5 [ DPI Product Type Overview ] Before You Begin (Introduction) Service Outline DPI(Digital Product Inventory) Portal Overview Outline on Samsung Checkout on TV Service Initiation Registration of Charged Products Issuance of Security Key Registration of Sales Country Product Registration Registration of Individual Product Multiple Product Registration Confirm Changes Product Status Flow and Life Cycle Sales Retire Refund Check on the Refunds on the App and Retrieval Check on the Refunds on the App and Retrieval Products with Subscription Period of Providing Product Purchase Information Programming Guide Programming Guide Outline Basic Feature Flow Sequence API Guide API Guide Outline Request Purchases List [POST] Request Products List [POST] Verify Purchase [POST] Apply Product [POST] Subscription Cancel [POST] CheckValue BuyItem Unity Plugin

4 Import Plugin BuyItem API Web Plugin Native Plugin References DPI Error Code Currency Code Country Code [Appendix 1 (TV Firmware Check Guide)] [Appendix 2 (Limitations when Saving Save Data inside TV)]

5 [ Glossary ] Term Samsung Billing / Payment Service CP / App Developer Freemium Paid App In-App Purchase Digital Product Inventory (DPI) Samsung Pay on TV (Billing Client) Operating Zone/ Staging Zone Operating TV / Development TV Description In this document, Samsung refers mostly to the Strategy Management Team of the Visual Display Division at Samsung Electronics. A service created in order to help monetary transactions between service providers and users Namely Content Provider and App Developer ; companies in charge of creating products suitable for consumers of the Smart TV Freemium, being a mix of the words free and premium, is a business model focused on optimizing income by providing free basic product to all users then offering all sorts of upgrades and solutions at a paid price. A service or app that can be only downloaded after making a payment. A method to pay for additional products and features within both free apps and paid apps. A system provided to developers to enter and manage extra products and items in their own apps. It is directly connected to the App Store. A payment UI module for consumers to add their choice of payment methods and pay for premium apps or special items. Operating Zone is a live environment where the real users get access to. Verification system is a test environment where 3rd party development and QA are conducted. (Sandbox Zone is regarded as Staging Zone.) Operating TV: TV purchased from on/off-line, TV with the same setting environment as the one in general users Development TV: TV that is made in use of a board separately provided by Samsung Electronics, TV that allows a setting environment for development different from the one for general users. 5

6 [ DPI Product Type Overview ] Product Type Description (Ex: Potion, Coin) Consumable Consumers can purchase this type of product anytime. Purchase history can be retrieved for 90 days. (Ex: All Stage Lock Released) Non-Consumable Consumers can purchase this type of product only once. Purchase history can be retrieved with no time restriction. (Ex: Two times more of the experience during 24 hours (can be repurchased after 24 hours)) Limited Period Once this type of product is purchased, repurchase cannot be made during the time when the product effect set by CP lasts. If Limited Period product type is chosen, the duration of time for the product effect to last can be entered in the units above minute. The duration time for the product effect to last is allowed for the maximum of 90 days. Purchase history can be retrieved for 90 days. CPs can review the entire purchase history from the DPI portal without any time restriction. (Ex: Provides item pack during monthly $10 subscription) Subscription DPI system processes automatic payment on a certain designated cycle. If subscription type of product is chosen, frequency and cycle can be selected. Once this type of product is purchased, repurchase cannot be made during the subscription period. Ex) Frequency = Every Month, Cycles = 5 : Five(5) times of automatic payment will be made every month since the day of first payment. 6

7 Paid App It means the service / application that can only be available by payment in advance. For using paid apps, when you register your app on DPI system you need to select it as paid app. 7

8 1. Before You Begin (Introduction) 1.1. Service Outline DPI(Digital Product Inventory) Portal Overview The DPI (Digital Product Inventory) Portal is a web service portal designed for CPs which helps them sell products and items through Smart TV apps. From DPI, CPs can register and manage products for sale and access the transaction history logs and sales reports for the applications they own. 1 The main functions of the DPI service are as follows. Paid item management (products and items) Order management (purchase history for each user) Detailed sales reports Coupon Management (creation and issuance of coupon) 2 The environments of the DPI service are as follows. (When submitting App after completing development integrated with Billing, the submission should be done after setting Staging Zone or Operating Zone to be seen in accordance with TV environment.) i. Operating Zone (Live / Production Environment) - Web Portal: - Open API : - Samsung Checkout on TV Parameter (BuyItem API 2 nd Parameter): PRD - For the TVs that are made in use of the development board separately provided by Samsung Electronics, DPI Operating Zone environment cannot be used. - The payment made in Operating Zone causes a charge on the part of CP when refund is made while being categorized as a real payment. Thus, beware not to use for the sake of test purpose. ii. Staging Zone (Test / Developing Environment) - Web Portal: - Open API: - Samsung Checkout on TV Parameter (BuyItem API 2 nd Parameter): DEV 8

9 - The Verification System is a development environment that is separately provided to ease the Billing Linkage Development. - An environment that has minimized the exceptional cases of each country when the real payment is made - TV purchased on/off-line (Operating TV) and TV that uses the board provided by Samsung Electronics (Development TV) can all use the DPI Staging environment. The Billing Linkage Development can be done after setting the environment that is in comfort with development. * Since the Data on the Operating Zone and the Data in Staging Zone cannot be shared, product type and price on both the Staging Zone and the Operating Zone should correspond when App is put into QA for game release. [Figure 1.0 Billing System Relation Map] When CP submits for the sake of App verification after completing the Samsung Billing Linkage Work, product information and price information in DPI Staging Zone / Operating Zone Portal should be checked whether they correspond or not, and the submission should be done after setting API to be called distinguishing Staging Zone (DEV) / Operating Zone (PRD) environment. Please refer to the example for a detailed method of use. 9

10 Example C# (During Development Staging Zone Environment) string strurldpi = " string strserver = "DEV"; Example C# (During App Submission Separated by Staging Zone(DEV) / Operating Zone(PRD) environment depending on the TV environment) if (SamsungTV.OpenAPI.serverType.ToString () == "Development") { string strurldpi = " string strserver = "DEV"; } else if (SamsungTV.OpenAPI.serverType.ToString () == "Operating") { string strurldpi = " string strserver = "PRD"; } else { Debug.Log ("INVALID ServerType : " + SamsungTV.OpenAPI.serverType.ToString ()); // Quit Application } 10

11 Outline on Samsung Checkout on TV Samsung Checkout on TV provides secure and easy purchase function to Samsung Smart TV platform. If the user purchases a charged product on a third party application, Samsung Checkout on TV carries out user identification, purchase confirmation, purchase completion confirmation. After the user completes the purchase on the charged product, Samsung Checkout on TV delivers the purchase result to a third party application. 1 The major functions of Samsung Checkout on TV are as follows: Common purchase GUI interface provided HTML based application and Native based application supported Various 3 rd Party Billing service provided Purchase result delivery to 3 rd Party application provided [Figure 1.2 Samsung Checkout on TV Chart Flow] 11

12 1.2. Service Initiation An account for the Smart TV Seller Office is required to use the DPI service. Once registered, CPs can use the DPI service by following these steps: 1 New app registration ( Request for registration ) into the Seller Office (Seller Office Portal) : Once a new app is registered, Seller Office will issue an AppID. This AppID is a key value linking the Seller Office and DPI systems for the CP. * When registering the App in the Seller Office, the option of Use Samsung Billing (found at the 2nd stage at the App registration stage) should be checked so as to link the DPI and Seller. 2 Request for service approval in DPI (DPI Portal) : Once the AppID is generated, the CP will be able to see the new app from the My Apps Details tab from DPI. 3 DPI Admin will review the request and grant the permission : Please contact the account manager if the permission isn t granted within 24 hours. [Figure 1.3 Service Approval Request] 12

13 1.3. Registration of Charged Products Issuance of Security Key Once app approval is complete in the DPI service, an application security key is issued to safely use the service. The issued key can be viewed under "App setting". The key is a security key to use API calls, and this is a protection mechanism for invalid access from/to the app and DPI. The related process is described in the section CheckValue. [Figure 1.4 Security Key Issuance] The issued security key is a key to be used for Open API calls made by a Smart TV app. Please be careful not to reveal this key to others. The value is different from the GSP AppSecret provided by GSP Service, so be cautious on its use Registration of Sales Country [Figure 1.5 Sales Country Registration] 1 You can check sales country on Management of Detailed Information menu on the App. 2 When expanding the countries available for service, seller should additionally register the country. 13

14 3 The list of countries that are additionally registered by seller is synchronized at UTC 5 ~ 6 o clock every day. (During these hours, access to the site is not available.) In order to equally apply the products to the countries that are newly added, you should process the following procedure on DPI: View Product List menu > Click on the products > Enter the information of the country newly added > Modify > Press Confirm button. 4 The synchronization on the list of countries to include the countries newly added by the seller can be done not only during the time when the daily automatic synchronization occurs, but also by accessing the Management of Detailed Information menu on the App. For the same application on the newly added products, the above procedure stated in 3 should be carried out. [Figure 1.6 Confirmation on the Detailed Information of Product] 14

15 Product Registration For product registration, both individual registration and batch registration are supported. After product registration, the registered product goes into 'sale ready' status and can be changed to sellable status after a confirmation process Registration of Individual Product Products can be registered under Add a New Product menu. [Figure 1.7 Individual Product Registration] 15

16 1 Product ID - Must be a unique ID within the app. 2 Sales country - List of countries registered on the Seller s site would be shown. (Refer to Registration of Sales Country) - Able to select countries on the list for the sales of product 3 Product Name - The product name can be entered for each country of sales. If left blank, the product name of the representative country will be applied. 4 Product Type - Types consist of Consumable, Non-Consumable, Limited Period, Subscription, and Paid App. i. Consumable : Consumers can purchase this type of product anytime. Purchase history can be retrieved for 90 days. ii. Non-Consumable : Consumers can purchase this type of product only once. Purchase history can be retrieved with no time restriction. iii. Limited Period : Once this type of product is purchased, repurchase cannot be made during the time when the product effect set by CP lasts. Purchase history can be retrieved for 90 days. If Limited Period product type is chosen, the duration of time for the product effect to last can be entered in the units above minute. The duration time for the product effect to last is allowed for the maximum of 90 days. CPs can review the entire purchase history from the DPI portal without any time restriction. iv. Subscription : DPI system processes automatic payment on a certain designated cycle. If subscription type of product is chosen, frequency and cycle can be selected. Ex) Frequency = Every Month, Cycles = 5 : Five(5) times of automatic payment will be made every month since the day of first payment. 16

17 v. Paid App : For paid apps, when you register your app on DPI system you need to select it as paid app. 5 Display Setting - Whether to display a product or not can be chosen. Display/Non-Display settings can be modified on DPI portal. Only the products which are set to be on display will appear on the API of calling on the product list. 6 Sales Expiry Date - Products which have not yet consumed Expiry Date are only displayed on the API of calling on the product list. This is used on the event items which are sold only for a certain period of time. 7 Sales price - Enter the price for each country for sales. Prices cannot go beyond the range of maximum price and minimum price, and if a price that is beyond such range, the price will be automatically changed to the maximum price, minimum price. Exchange rate is automatically applied based on the value entered for the representative country Multiple Product Registration More than one item can be registered at the same time under the Add Multiple Products menu. Download the provided CSV template, enter the details according to the registration form and register the products. [Figure 1.8 Multiple Product Registration] 17

18 Cautions on Formats i. Product ID : Alphanumeric and two special characters ('-', '_') are allowed. (Maximum 32 bytes) ii. Representative product name : The name of the product used in the representative country must be entered in the Region;Name field. This field cannot be left empty. iii. Type : Permitted product types are 'CONSUMABLE', 'NON_CONSUMABLE' and 'LIMIT_PERIOD'. iv. Period : If the product type is 'LIMIT_PERIOD', a number fewer than 129,600 in minutes is allowed. (Maximum 90 days) v. Active (Visibility) : A field indicating whether the product can be sold; true' or 'false' is allowed. vi. Country;Product Name : The country and product name are separated by ';' and a maximum of 50 bytes of product name is allowed. If more than one country is entered, use '&' as a separator. Country codes are based on ISO alpha-2 and unsupported countries are automatically deleted if entered. vii. Country;Product Price : The country and price information are separated by ';', and if more than one country is input, the use of the '&' separator is required. Selling prices are limited to minimum/maximum price ranges supported by the system (reference price for each currency). If a price goes beyond the range, it is automatically reverted to the specified maximum or minimum price. Country codes are based on ISO alpha-2 and unsupported countries are automatically deleted if entered. Price quantity fields for countries registered in sales settings must be entered. 18

19 Confirm Changes This is a step to confirm the products before putting them directly on sale or making changes. If product is registered, modified or deleted, it is not directly set as available for sale and changes are registered in the Pending tab. If the seller checks the list of registered items and confirms its products, the corresponding products are set as available for sale. It is possible to check details in Product list tab. [Figure 1.9 Sales Confirmation] 19

20 Product Status Flow and Life Cycle Product Status Description Visibility Setting Visible to Users Inactive Initial status before saving Show Hide No Show Pending (1) After saving a new item Hide No Active After accepting the Show Yes changes Hide No Pending (2) After making modifications Show Yes (Active is shown) to an active item Hide No Deleted from the list for N/A Retired an item that has been sold No N/A at least once Deleted from the list for N/A Deleted an item that has never been sold (Removed from N/A the DPI entirely) No Change Pending (2) Pending Pending modifications to an active item START Initial status for a new item Product Pending Register (1) Active Sold at least once Pending - Retire Retired END Never been sold Deleted [Figure 1.10 Product Status Flow Chart] 20

21 Sales Retire In order to suspend the sales of a particular product, when Retire button on the [Product List]- [Product Details] page is pressed, the relevant product is set to be in the Retire status, and the purchase of the product is disenabled since then. For already made purchases on the product, refund should be considered depending on the policy of CP, and the refund on the purchases should be made by [Transaction List (All Apps)] menu. Return on the products finished with refund should be done in reference to Chapter Retire button can be checked on [Product List]-[Product Details] Page. [Figure 1.11 Product Retire] Products with no purchase history can be done with Delete not Retire, and the products deleted cannot be purchased and cannot be viewed on product list. Delete button can be checked on [Product List] menu. [Figure 1.12 Product Delete] 21

22 Refund To get refund on the purchase history for tests or if a user requested for a refund, a CP can directly give refund for each of transaction on [Sales Management]-[Transaction List (All Apps)] page. Refund Button can be checked on the [Transaction List (All Apps)] menu. [Figure 1.13 Transactions Refund] Check on the Refunds on the App and Retrieval When calling Request Purchases List API after running the application, purchase history with CancelStatus Parameter on the Response being true are deemed to be refunded, and CP should retrieve the product by itself. However, the products with subscription can be checked in a different way, and please refer to Chapter for details Check on the Refunds on the App and Retrieval Products with Subscription For the case of the products with subscription, cancellation and refund have different meaning. 1. Cancellation Cancellation means payment being disabled from the next Cycle. This means the previous purchase history including the current payment Cycle not being refunded. Thus, the user will be in a status of payment up to the current Cycle. If the user wants to use the service again, then the user should purchase a subscription product again. 2. Refund Refund can be made for the payments made for each Cycle. Refund and Cancellation are separate. If only Refund is being made, payment for the next following Cycle will continue. If a user requests for refund, 22

23 the request should be distinguished whether the user wants the refund only for the current Cycle, or the user wants no payment for the upcoming Cycle as well. If the user wants no payment for the upcoming Cycle, the refund and cancellation should be done as stated below: i. Select the ID of the product on subscription on [Manage Subscriptions] menu. ii. Select the ID registered on subscription (Invoice ID) that requested for refund. iii. For the next step, process both the Cancellation on the overall Cycle and Refund side by side. 1 Click on the [Refund] button and process Refund. 2 Click on the [Cancellation] button and process cancellation on the overall subscription Cycle. 3 Click on the [Change End Date] button and change the subscription end date. (However, changing the subscription end date to a date earlier than the date of today is not possible.) In order to check whether the refund is being made or not, App code should be configured to identify whether the subscription service period has been expired or not by checking SubsEndTime Parameter of the Response when Request Purchases List API was called after running the App. 23

24 Period of Providing Product Purchase Information DPI provides information on the status for the products purchased by users through Request Purchases List API. In case the purchased product is not applied on the real game, the status can be checked on the Product Applied Status). In case the purchased product was refunded to the user, the status can be checked on the Sales Cancellation Status. The period of time the above status information is provided through API to the application can be classified by the product type as shown below. Normal Product Type Application (Purchase Non-Application Sales Cancellation History) Consumable Application Date (Ex: Potion, Coin) + 90days All products with payment Non-Consumable completion can (Ex: All Stage Lock Released) be viewed Limited Period (Ex: Two times more of the experience during 24 hours) irrespective of condition (Application date + Product Period) + 90days All products can be viewed with no restrictions in time period Sales Cancellation Date (Refund Date) + 90 days All products with Subscription (Ex: Provides item pack during monthly $10 subscription) payment completion can be viewed irrespective of condition CPs can check all product purchase history on the DPI Portal with no restrictions in time period. 24

25 2. Programming Guide 2.1. Programming Guide Outline CP can develop In-app-purchase function by using open API provided by DPI. DPI service provides information on sellable products and purchase history of each customer on application, and also the procedure for the management of product application (Apply Product API) in an effort to guarantee secure sales of products. Samsung Checkout on TV provides secure and easy purchase function on Samsung Smart TV platform. When a user purchases a charged product on 3 rd party application, Samsung Checkout on TV carries out user identification, purchase confirmation, and purchase completion confirmation. After a user finishes the purchase on a charged product, Samsung Checkout on TV delivers the result of purchase to 3 rd party application. In other words, CP can manage product application and product sales through DPI and proceed the actual purchase through Samsung Checkout on TV Basic Feature The DPI and Samsung Checkout on TV provides major functions as illustrated hereunder. <Major Functions of DPI> 1 Provide product information for each country 2 Provide user-specific purchase information 3 Assure purchase integrity 4 Manage application of product after purchase 5 Security function through prevention of fraudulent access <Major Functions of Samsung Checkout on TV> 1 Provide GUI Interface for Common Purchase 2 Support HTML based application and Native based Application 3 Support various 3 rd Party Billing Service 4 Deliver purchase result to 3 rd party application 25

26 Flow The payment service supports purchase management and payment as shown in the following flow. 1 App execution 2 Request for user's purchase product list (Refer to 3.1.1) i. If there is non-applied product(appliedstatus) in the delivered purchase list, apply the product. If there is refunded product(cancelstatus) in the delivered purchase list, retrieve the product. ii. After application, send the application result to the server. (Refer to 3.1.3, 3.1.4) 3 Request for product list (Refer to 3.1.2) 4 Purchase the product. i. In case the user selected the Buy button in the 3 rd party application, Samsung Checkout on TV carries out common purchase GUI. ii. User enters the account and passcode of the 3 rd party Billing service or the phone number and PIN number on the common purchase GUI. iii. Samsung Checkout on TV delivers the purchase result to 3 rd party application if the user finishes the purchase of charged product. iv. The 3 rd party application confirms the success/failure of purchase on the server for charged product item and reflects the result on the application. v. Purchase completes. 5 Re-check the purchase result of the product. (Refer to 3.1.3) 6 Apply the product. 7 Send the application result to the server. (Refer to 3.1.4) 26

27 Sequence The above flow can be drawn as a sequence as shown below. [Figure 2.1 Payment Sequence] 27

28 3. API Guide 3.1. API Guide Outline DPI server is operated by distinguishing Staging Zone, which is an environment for development, and Operating Zone, which is for the real service. Staging Zone(DEV) should be used during development, and Staging Zone(DEV) and Operating Zone(PRD) should be used during App submission in accordance with TV environment, and a different OpenAPI should be used thereby. DPI provides five APIs for sale and management of products as follows, and supports POST method in JSON data format for communication. Request Purchase List [POST] Request Products List [POST] Verify Purchase [POST] Apply Product [POST] Subscription Cancel [POST] DPI uses CheckValue which is a base64 hash value made from the HMAC SHA256 algorithm and KEY in order to assure the integrity of data. The method of creating CheckValue is also illustrated in this chapter. CheckValue A separate API provided by a separate Plugin should be used in order to run the Samsung Checkout on TV on the App. In this case, Plugin is provided in three separate engines for each individual engine as shown below. Unity Plugin BuyItem API Web Plugin BuyItem API Native Plugin BuyItem API By referring to the example provided in the relevant chapter, should be applied to the real application scenarios. 28

29 Request Purchases List [POST] 1 Description - Requests the list of purchased items for a specific user (usually the currently logged in user). - By referring to the Response of the API on the App, whether the purchase history has been normally reflected on the App(AppliedStatus) or whether the purchase history of the user has been refunded(cancelstatus) can be identified. - However, for the case of subscription product, default value of AppliedStatus is true, CancelStatus does not indicate the refund status of the purchase history, but cancellation status of the next subscription Cycle. SubsEndTime shows refund status of the purchase history(termination of subscription). 2 API URL - Staging Zone (DEV): [POST] - Operating Zone (PRD): [POST] 3 Request Body Parameters Type Mandatory Description AppID String True Application ID CustomID String True * Same as the OrderCustomID which is the BuyItem API Parameter Customer ID (Samsung Account UID) CountryCode String True [Country code] *refer to 4.3 country code - The value for country code should not be written arbitrarily, but should be written after receiving the information from TV. [Requested product type] 1: NON-CONSUMABLE and LIMITED-PERIOD 2: ALL ItemType String True * For non-applied products after purchase, purchase information is provided until it is applied without any limit in the type-specific provision period. 29

30 PageNumber Number True CheckValue String True (Refer to description on product types in Individual Registration) [Requested page number] (1-N, each page has #PageSize entries of product information) *Up to 100 purchase records are provided at a time. To receive the entire purchase history, request product information while increasing the page number until EOF is returned [Security Hash Code] * Necessary Parameters : APPID + CustomID + CountryCode + ItemType + PageNumber * Refer to CheckValue 4 Response Parameters Type Mandatory Description Result code CPStatus String True (Success) ErrorCode (Failure) (Refer to 4.1 DPI Error Code) CPResult String False Result Message EOF or Error Short Message TotalCount Number True Total number of products CheckValue String True Security hash code (refer to CheckValue) InvoiceDetails JSON False [Invoice Info] Seq Number True Sequence number (1 ~ TotalCount) InvoiceID String True Invoice ID ItemID String True Product ID ItemTitle String True Product name [Product type] 1 : CONSUMABLE 2 : NON-CONSUMABLE ItemType Number True 3 : LIMITED-PERIOD 4 : SUBSCRIPTION *The response ItemType is a parameter that is in different attribute from the Request ItemType. This shows the type information of 30

31 products that is classified in detail. OrderTime String True Payment time (UTC-zero, ex> ) Period Number False Period (Minutes) Price Number True Price (xxxx.yy) OrderCurrencyID String True Currency code (refer to 4.2 Currency Code) CancelStatus Boolean True [Sales Cancellation Status] 1 true : Sales Cancellation 2 false : Sales Ongoing *for the case of subscription product, refers to the cancellation status of the next subscription Cycle AppliedStatus Boolean True [Product Application Status] 1 true : Applied 2 false : Not Applied *for the case of subscription product, default value is true(applied) AppliedTime String False [Applied Time] (UTC-zero, ex> ) * The starting time of using limited period product is applied on the standard of the AppliedTime field. LimitEndTime String False Only applies to limited period products. AppliedTime + Period (UTC-zero, ex> ) RemainTime String False Only applies to limited period products. LimtEndTime The time when invoice/list was called for is converted (seconds) SubscriptionInfo JSON False [SubscriptionInfo] Mandatory when producttype is SUBSCRIPTION SubscriptionId String True [Subscription ID] SubsStartTime String True [Subscription Registration Date] ( UTC-zero, ex> ) SubsEndTime String True [Subscription Expiry Date] ( UTC-zero, ex> ) 31

32 SubsStatus String True [Subscription Status] 00: Active 01 : Subscription Period Finished 02 : Cancellation by the User 03 : Cancellation by the payment failure 04 : Cancellation by CP 05 : Cancellation by admin Request Sample HTTP/1.1 Content-Type : application/json;charset=utf-8 Content-Length:0 Accept:application/json { "AppID": " ", "CustomID": customid00, "CountryCode" : "US", "ItemType" : "2", "PageNumber" : 1, "CheckValue": "EW2uZl3ejDM2P3R4w5ouE ", } Response Sample Content-Type: application/json; charset=utf-8 Content-Length: {"CPStatus" : "100000", "CPResult" : "EOF", "TotalCount" : 20, "CheckValue" : "EW2uZl3ejDM2P3R4w5ouE ", "ItemDetails" : [ {"Seq" : 1, "InvoiceID" : " DO1234KR ", "ItemID" : " ", "ItemTitle" : "product 2", "ItemType" : "1", "OrderTime" : " ", "Period" : "", "Price" : "12.22","OrderCurrencyID" : "USD", "CancelStatus" : false, "AppliedStatus" : true, "AppliedTime" : }, { "Seq": 20, "InvoiceID": "DO4321KR ", "ItemID": "product_id_sub_1", "ItemTitle": " subscription product title", "ItemType": 4, "OrderTime": " ", "Period": 0, "Price": 2.22, "OrderCurrencyID": "USD", "CancelStatus": false, "AppliedStatus": true, "AppliedTime": "", 32

33 "SubscriptionInfo": { "SubscriptionId": "DO1503KR ", "SubsStartTime": " ", "SubsEndTime": "", "SubsStatus": "00" } }, ]} Request Example (Unity - C# Script) // Must input provided App ID, ApplicationSecret Key // Must input the country code, UID obtained from TV. string strappid = "12345"; // YOUR APPID string strcountry = GSP.GSPSystem.getCountry().ToUpper(); // GSP API. It should be CAPITAL LETTERS string struid = SamsungTV.OpenAPI.uid.ToString(); // Unity OpenAPI // During development, use Staging Zone(DEV) address and Parameter (Must be changed when submit to Samsung) string strserver = " string strtarget = "DEV"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL // When submit app to Samsung, use Staging Zone(DEV) / Operating Zone(PRD) environment depending on the TV environment. /* if (SamsungTV.OpenAPI.serverType.ToString () == "Development") { string strurldpi = " string strserver = "DEV"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else if (SamsungTV.OpenAPI.serverType.ToString () == "Operating") { string strurldpi = " string strserver = "PRD"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else { Debug.Log ("INVALID ServerType : " + SamsungTV.OpenAPI.serverType.ToString ()); // Quit Application } */ // Function for making CheckValue should be configured directly. (refer to CheckValue) string strencript = getcheckvalue(strappid+struid+strcountry , strapplicationsecret); // Must maintain Jason format string strparam = "{\"AppID\":\"" + strappid +"\",\"CountryCode\":\"" + strcountry + "\",\"CustomID\":\"" + struid + "\",\"ItemType\":\"2\",\"PageNumber\":\"1\",\"CheckValue\" : \"" + strencript + "\"}"; Hashtable header = new Hashtable(); header.add("content-type", "text/json"); header.add("content-length", strparam.length.tostring()); byte[] result = System.Text.Encoding.ASCII.GetBytes(strParam); WWW www = new WWW(strServer, result, header); yield return www; if ( null) { 33

34 } else { } Debug.Log("request error: " + Debug.Log("request success"); Debug.Log("returned data" + ); // add your code Request Products List [POST] 1 Description - Request product information on DPI server. The information of products on sale in Show status is returned. This is generally used in bringing the list of products available for sale on the in-app purchase store. 2 API URL - Staging Zone(DEV): [POST] - Operating Zone(PRD): [POST] 3 Request Body Parameters Type Mandatory Description AppID String True Application ID [Country code] *refer to 4.3 country code CountryCode String True - The value for country code should not be written arbitrarily, but should be written after receiving the information from TV. [Security Hash Code] CheckValue String True * Necessary Parameters : APPID + CountryCode * Refer to CheckValue PageSize Number False [The Size of the Requested Page] *The number of exposed on each page ((1-N) [The Number of Requested Page] (1-N, Each page has the size of the whole product information.) PageNumber Number False *Up to 100 units of purchase history is provided. To have the whole purchase list, request of product information should be done until all the product information list is created to its end. 34

35 4 Response Parameters Type Mandatory Description CPStatus String True Result code (Success) ErrorCode (Failure) (Refer to 4.1 DPI Error Code) CPResult String False Result Message EOF or Error Short Message TotalCount Number True The number of all products CheckValue String True Security Hash Code (3.1.5 CheckValue) ItemDetails JSON False [Item Details] Seq Number True Sequence number (1 ~ TotalCount) ItemID String True Product ID ItemTitle String True Product name ItemDesc String False Product description ItemType Number True [Product Type] 1 : CONSUMABLE 2 : NON-CONSUMABLE 3 : LIMITED-PERIOD 4 : SUBSCRIPTION Period Number False Period (Minutes) Price Number True Price (xxxx.yy) CurrencyID String True Currency Code (Refer to 4.2 Currency Code) subscriptioninfo JSON False [SubscriptionInfo] Mandatory when producttype is SUBSCRIPTION PaymentCyclePeri Payment cycle Period String True od D : day(s), W : week(s), M : month(s) PaymentCycleFrq Number True Frequency of payment cycle PaymentCycle Number True After how many cycles should billing stop Request Sample HTTP/1.1 Content-Type : application/json;charset=utf-8 Content-Length:0 Accept:application/json { "AppID": " ", "CountryCode" : "US", "CheckValue" : "EW2uZl3ejDM2P3R4w5ouE ", "PageSize" : 20, "PageNumber" : 1 } 35

36 Response Sample Content-Type: application/json; charset=utf-8 Content-Length: { "CPStatus" : "100000", "CPResult" : "EOF", "TotalCount" : 7, "CheckValue" : "X2Y8w1bjpLzuTApdJUyfH294vqfb2 ", "ItemDetails" : [ { "Seq" : 1, "ItemID" : "non consumable item", "ItemTitle" : "non_consum_1", "ItemDesc" : "", "ItemType" : 2, "Period" : 0, "Price" : 9.99, "CurrencyID" : "USD" }, { "Seq" : 2, "ItemID": "product_id_sub_1", "ItemTitle": "subscription product title", "ItemDesc": "monthly subscription product", "ItemType": 4, "Period": 0, "Price": 2.12, "CurrencyID": "USD", "SubscriptionInfo": { "PaymentCyclePeriod": "M", "PaymentCycleFrq": 1, "PaymentCycle": 12}, { }] } Request Example (Unity - C# Script) // Must input provided App ID, ApplicationSecret Key // Must input the country code, UID obtained from TV. string strappid = "12345"; // YOUR APPID string strcountry = GSP.GSPSystem.getCountry().ToUpper(); // GSP API. It should be CAPITAL LETTERS string struid = SamsungTV.OpenAPI.uid.ToString(); // Unity OpenAPI // During development, use Staging Zone(DEV) address and Parameter (Must be changed when submit to Samsung) string strserver = " string strtarget = "DEV"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL // When submit app to Samsung, use Staging Zone(DEV) / Operating Zone(Live) environment depending on the TV environment. /* if (SamsungTV.OpenAPI.serverType.ToString () == "Development") { string strurldpi = " string strserver = "DEV"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL 36

37 } else if (SamsungTV.OpenAPI.serverType.ToString () == "Operating") { string strurldpi = " string strserver = "PRD"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else { Debug.Log ("INVALID ServerType : " + SamsungTV.OpenAPI.serverType.ToString ()); // Quit Application } */ // Function for making CheckValue should be configured directly. (refer to CheckValue) string strencript = getcheckvalue(strappid + strcountry, strapplicationsecret); // Must maintain Jason format. string strparam = "{\"AppID\":\"" + strappid +"\",\"CountryCode\":\"" + strcountry + "\",\"PageSize\":\"100\",\"PageNumber\":\"1\",\"CheckValue\" : \"" + strencript + "\"}"; Hashtable header = new Hashtable(); header.add("content-type", "text/json"); header.add("content-length", strparam.length.tostring()); byte[] result = System.Text.Encoding.ASCII.GetBytes(strParam); WWW www = new WWW(strServer, result, header); yield return www; if ( null) { Debug.Log("request error: " + } else { Debug.Log("request success"); Debug.Log("returned data" + ); // add your code } 37

38 Verify Purchase [POST] 1 Description - To check whether a purchase corresponding to the requested InvoiceID was successful or not. 2 API URL - Staging Zone (DEV): [POST] - Operating Zone (PRD): [POST] 3 Request Parameters Type Mandatory Description AppID String True Application ID InvoiceID String True Invoice ID CustomID String True Customer ID (Samsung Account UID) CountryCode String True [Country code] *refer to 4.3 country code - The value for country code should not be written arbitrarily, but should be written after receiving the information from TV. 4 Response Parameters Type Mandatory Description CPStatus String True Result code (Success) ErrorCode (Failure) (Refer to 4.1 DPI Error Code) CPResult String False Result Message SUCCESS or Error Short Message AppID String True Requested App ID InvoiceID String True Requested Invoice ID Request Sample HTTP/1.1 Content-Type : application/json;charset=utf-8 Content-Length:0 Accept:application/json { "AppID" : " ", "InvoiceID" : "DO1234KR ", "CustomID" : "aud122qe39", "CountryCode" : "US", } 38

39 Response Sample Content-Type: application/json; charset=utf-8 Content-Length: { "CPStatus" : "100000", "CPResult" : " SUCCESS", "AppID" : " ", "InvoiceID " : "DO1234KR " } Request Example (Unity - C# Script) // Must input provided App ID, ApplicationSecret Key // Must input the country code, UID obtained from TV. string strappid = "12345"; // YOUR APPID string strcountry = GSP.GSPSystem.getCountry().ToUpper(); // GSP API. It should be CAPITAL LETTERS string struid = SamsungTV.OpenAPI.uid.ToString(); // Unity OpenAPI // During development, use Staging Zone(DEV) address and Parameter (Must be changed when submit to Samsung) string strserver = " string strtarget = "DEV"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL // When submit app to Samsung, use Staging Zone(DEV) / Operating Zone(PRD) environment depending on the TV environment. /* if (SamsungTV.OpenAPI.serverType.ToString () == "Development") { string strurldpi = " string strserver = "DEV"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else if (SamsungTV.OpenAPI.serverType.ToString () == "Operating") { string strurldpi = " string strserver = "PRD"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else { Debug.Log ("INVALID ServerType : " + SamsungTV.OpenAPI.serverType.ToString ()); // Quit Application } */ // InvoiceID of an item with AppliedStatus = false obtained from Request Purchases List API string strinvoiceid = ""; // Must maintain Jason format string strparam = "{\"AppID\":\"" + strappid +"\",\"CountryCode\":\"" + strcountry + "\",\"CustomID\":\"" + struid + "\",\"InvoiceID\":\"" + strinvoiceid + "\"}"; Hashtable header = new Hashtable(); header.add("content-type", "text/json"); header.add("content-length", strparam.length.tostring()); byte[] result = System.Text.Encoding.ASCII.GetBytes(strParam); WWW www = new WWW(strServer, result, header); yield return www; 39

40 if ( null) { Debug.Log("request error: " + } else { Debug.Log("request success"); Debug.Log("returned data" + ); } // add your code 40

41 Apply Product [POST] 1 Description - The DPI is notified that the purchased product has been successfully applied to the app. The Apply Product Open API is prepared for cases where the purchase result is not delivered to the app. In abnormal network status, there may be situations where the payment has been completed but the app does not receive the payment complete message. In those cases, the product is not applied to the app. It is possible to apply the product to the app by checking the AppliedStatus of the response message after the app s call for Request Purchases List API (generally, right after the app has been executed). - However, in case of subscription product, the product is deemed to be applied right at the point when purchase is made, and the Applied Status is set to be true. Thus, the relevant API does not need to be used. If errors occur more than three times, it is recommended that the product is kept in nonapplied status and Apply Product is requested again after the network connection becomes normal (to exclude the possibility of the same product being applied twice). 2 API URL - Staging Zone (DEV): [POST] - Operating Zone (PRD): [POST] 3 Request Parameters Type Mandatory Description AppID String True Application ID InvoiceID String True Invoice ID CustomID String True Customer ID (Samsung Account UID) CountryCode String True [Country code] *refer to 4.3 country code - The value for country code should not be written arbitrarily, but should be written after receiving the information from TV. 4 Response Parameters Type Mandatory Description CPStatus String True Result code 41

42 CPResult String False AppliedTime String True (Success) ErrorCode (Failure) (Refer to 4.1 DPI Error Code) Result Message SUCCESS or Error Short Message Product Applied Time (UTC-zero, ex> ) Request Sample HTTP/1.1 Content-Type : application/json;charset=utf-8 Content-Length:0 Accept:application/json { "AppID": " ", "InvoiceID" : "DO1234KR ", "CustomID" : " ", "CountryCode" : "US", } Response Sample Content-Type: application/json; charset=utf-8 Content-Length: { } "CPStatus" : "100000", "CPResult" : " SUCCESS", "AppliedTime" : " ", Request Example (Unity - C# Script) // Must input provided App ID, ApplicationSecret Key // Must input the country code, UID obtained from TV. string strappid = "12345"; // YOUR APPID string strcountry = GSP.GSPSystem.getCountry().ToUpper(); // GSP API. It should be CAPITAL LETTERS string struid = SamsungTV.OpenAPI.uid.ToString(); // Unity OpenAPI // During development, use Staging Zone(DEV) address and Parameter (Must be changed when submit to Samsung) string strserver = " string strtarget = "DEV"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL // When submit app to Samsung, use Staging Zone(DEV) / Operating Zone(Live) environment depending on the TV environment. /* if (SamsungTV.OpenAPI.serverType.ToString () == "Development") { string strurldpi = " string strserver = "DEV"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else if (SamsungTV.OpenAPI.serverType.ToString () == "Operating") { 42

43 string strurldpi = " string strserver = "PRD"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else { Debug.Log ("INVALID ServerType : " + SamsungTV.OpenAPI.serverType.ToString ()); // Quit Application } */ // InvoiceID of an item with AppliedStatus = false obtained from Request Purchases List API string strinvoiceid = ""; // Must maintain Jason format string strparam = "{\"AppID\":\"" + strappid +"\",\"CountryCode\":\"" + strcountry + "\",\"CustomID\":\"" + struid + "\",\"InvoiceID\":\"" + strinvoiceid + "\"}"; Hashtable header = new Hashtable(); header.add("content-type", "text/json"); header.add("content-length", strparam.length.tostring()); byte[] result = System.Text.Encoding.ASCII.GetBytes(strParam); WWW www = new WWW(strServer, result, header); yield return www; if ( null) { Debug.Log("request error: " + } else { Debug.Log("request success"); Debug.Log("returned data" + ); } // add your code 43

44 Subscription Cancel [POST] 1 Description - Available to be used only when the product type is subscription product. - Request cancellation for the registration made for subscription on DPI server. DPI returns the expiry date when the relevant subscription registered product actually expires, and the status thereof. 2 API URL - Staging Zone (DEV) : - Operating Zone (PRD) : 3 Request Parameters Type Mandatory Description AppID String True Application ID InvoiceID String True Invoice ID CustomID String True Customer ID (Samsung Account UID) CountryCode String True [Country Code] * Refer to 4.3 Country Code - Country Code value should not be input arbitrarily, but should be based on the information obtained from TV. 4 Response Parameters Type Mandatory Description Result code CPStatus String True (Success) ErrorCode (Failure) (Refer to 4.1 DPI Error Code) CPResult String False Result Message SUCCESS or Error Short Message InvoiceID String True Invoice ID return the time when cancellation was complete after SubsCancelTime String False subscription cancel requested Subscription Canceled time ( UTC-zero, ex> ) SubsStatus String False Subscription status 00: active 44

45 Request Sample 01 : Finished cyclic payment (Expired) 02 : canceled subscription (Canceled by Buyer) 03 : canceled subscription by cyclic payment fail (Canceled ( Payment Failure)) 04 : Canceled by CP 05 : Canceled by Admin HTTP/1.1 Content-Type : application/json;charset=utf-8 Content-Length:0 Accept:application/json { "AppID": " ", "InvoiceID" : "DO1234KR ", "CustomID" : " ", "CountryCode" : "US", } Response Sample Content-Type: application/json; charset=utf-8 Content-Length: { "CPStatus" : "100000", "CPResult" : "SUCCESS", "InvoiceID" : "DO1234KR ", "SubsCancelTime" : " ", "SubsStatus" : "04", } Request Example (Unity - C# Script) // Must input provided App ID, ApplicationSecret Key // Must input the country code, UID obtained from TV. string strappid = "12345"; // YOUR APPID string strcountry = GSP.GSPSystem.getCountry().ToUpper(); // GSP API. It should be CAPITAL LETTERS string struid = SamsungTV.OpenAPI.uid.ToString(); // Unity OpenAPI // During development, use Staging Zone(DEV) access address and Parameter (Must be changed when submit to Samsung) /* string strserver = " ; string strtarget = "DEV"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL */ // // When submit app to Samsung, use Staging Zone(DEV) / Operating Zone(Live) environment depending on the TV environment. /* if (SamsungTV.OpenAPI.serverType.ToString () == "Development") { string strurldpi = " string strserver = "DEV"; 45

46 string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else if (SamsungTV.OpenAPI.serverType.ToString () == "Operating") { string strurldpi = " string strserver = "PRD"; string strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else { Debug.Log ("INVALID ServerType : " + SamsungTV.OpenAPI.serverType.ToString ()); // Quit Application } */ // InvoiceID of an item with AppliedStatus = false obtained from Request Purchases List API string strinvoiceid = ""; // Must maintain Jason format string strparam = "{\"AppID\":\"" + strappid +"\",\"CountryCode\":\"" + strcountry + "\",\"CustomID\":\"" + struid + "\",\"InvoiceID\":\"" + strinvoiceid + "\"}"; Hashtable header = new Hashtable(); header.add("content-type", "text/json"); header.add("content-length", strparam.length.tostring()); byte[] result = System.Text.Encoding.ASCII.GetBytes(strParam); WWW www = new WWW(strServer, result, header); yield return www; if ( null) { Debug.Log("request error: " + } else { Debug.Log("request success"); Debug.Log("returned data" + ); } // add your code 46

47 CheckValue CheckValue parameter is used to guarantee integrity of data. Checkvalue is base64 hash value which is made from HMAC SHA256 algorithm and KEY. CP can identify KEY for each App on DPI portal. KEY is a string of 44 lengths, and is changed to 32byte after going through base64 decoding. CheckValue should be made before the request on open API, and should be inside JSON parameter at the time of request. In case there is no CheckValue on API request, DPI recognizes the request as an access from an unknown user, and the result of response cannot be obtained. The method of making CheckValue is as follows. 1 Bring in all the necessary parameter value. 2 Call on SHA256 API with the KEY and necessary parameters. 3 Call on Base64 encoding API with the result from number 2. The above value is valid also when checking for response data on CP s side. DPI also creates the CheckValue (The value of the parameter used when creating CheckValue are CPStatus, CPResult, TotalCount, ItemID(1), ItemID(2). ItemID follows the seq parameter.) by the above mentioned method and returns the value by putting inside the JSON. CP checks whether the data is from DPI server by looking at the CheckValue. In order to cope with attacks on App such as reverse engineering, etc. in a more secure manner, the structure of managing the key in the relevant server by using the key management server on the CP company can be applied. [Example Code (C#)] public string getcheckvalue(string strmsg, string strkey ) { var encoding = new System.Text.ASCIIEncoding(); byte[] bytekey = encoding.getbytes(strkey); byte[] datatohmac = encoding.getbytes(strmsg); HMACSHA256 hmac = new HMACSHA256(byteKey); return Convert.ToBase64String(hmac.ComputeHash(dataToHmac)); } 47

48 BuyItem To carry out user identification and purchase on charged items, purchase GUI should be implemented. Different Plugin for different development engine should be imported and called for, and the method of such is explained below for each Plugin Unity Plugin Unity Application applies Billing Plugin for Unity provided separately, and calls on BuyItem API Import Plugin 1 Download PaypallBilling_YEARMMDD.unitypackage on the PC where App is developed. 2 Add in the Unity Editor following the below method. A. Unity Menu -> Import Package -> Custom Package BuyItem API 1 Description - Implement Common Purchase GUI which is for user identification and purchase. 2 Request Body BillingAppPlugin.BuyItem(appID, PaymentServer, PaymentDetails) Parameters Type Mandatory Description AppID String True AppID provided by Samsung Seller Site PaymentServer String True Element for the selection of payment server ( DEV : Element accessing through Staging Zone server - When using DPI Staging Zone (during development, during QA)) ( PRD : Element accessing through the actual payment server - When using DPI Operating Zone (Actual User Environment)) PaymentDetails JSON True [Payment Details] OrderItemID String True OrderTitle String True * ItemID returned through DPI cont/list API. Item ID for purchase (ex. A-001) * ItemTitle returned through DPI cont/list API. Payment Title 48

49 OrderTotal String True OrderCurrencyID String True OrderID String False OrderCustomID String True * Price returned through DPI cont/list API. * Type must be changed to String Total amount of purchase * CurrencyID returned through DPI cont/list API. Purchase currency unit (ex. USD) Management ID for purchase managed by 3 rd party application * Same as the CustomID which is the DPI invoice/list API Parameter Value for classification to distinguish users In case of using Samsung Account, UID is to be used. (ex ) If the value of the OrderCustomID is "" or NULL, Samsung Account UID value is used. 3 Response Parameters Type Mandatory Description intrtnvalue int True - 1 : Success - 2 : Failure - 3 : Cancellation (Payment App closed on user s request) - 0 : Unknown Error Example (Unity - C# Script) // C# Script string strappid = yourappid ; string strapplicationsecret = ; string strserver = ; string strurldpi = ; //During development strurldpi = sbox-dpiapi.samsungcloudsolution.com/openapi ; strserver = DEV ; strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL //During App submission - use Staging Zone(DEV) / Live environment(prd) depending on the TV environment /* if (SamsungTV.OpenAPI.serverType.ToString () == "Development") { strurldpi = " strserver = "DEV"; strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else if (SamsungTV.OpenAPI.serverType.ToString () == "Operating") { strurldpi = " strserver = "PRD"; strapplicationsecret = "*****"; // YOUR SECURITY KEY ISSUED BY DPI PORTAL } else { Debug.Log ("INVALID ServerType : " + SamsungTV.OpenAPI.serverType.ToString ()); // Quit Application 49

50 } */ //3.1.2 Refer to Request Products List (cont/list) API Guide string strdetails = "{\"OrderItemID\":\"v-001\",\"OrderTitle\":\"Man of Steal\", \"OrderTotal\":\"15.00\",\"OrderCurrencyID\":\"USD\"}"; int rtnvalue = -1; rtnvalue = BillingAppPlugin.BuyItem(strAppID, strserver, strdetails); Web Plugin Web Plugin detailed guide and example are provided separately Native Plugin Native Plugin detailed guide and example are provided separately with Billing Plugin. 50

51 4. References 4.1. DPI Error Code Code Message Description 1 Basic Message - SUCCESS 2 Additional messages - If products/purchases history is exist, and have the following page : hasnext:true - If products/purchases history is exist, and it is the last page : EOF - If purchases history doesn t exist : Your Invoice Not Found AppID not correct Refer to DPI Portal [Help] -> [Error Code] Success When requested App ID does not exist Other Errors 51

52 4.2. Currency Code - This chart is for reference. When running Samsung Checkout on TV Module, please refer to the CurrencyID in the response for Request Product List. Name US Dollar Canadian Dollar Pound Sterling Euro Australian Dollar Turkey Dollar Dirham Zloty Swiss Franc Krona Lev Czech Krona Forint Denmark Krona Norway Krona Ruble Mexico Peso Shekel Peso Argentina Peso Riyal Real Code USD CAD GBP EUR AUD TRY AED PLN CHF SEK BGN CZK HUF DKK NOK RUB MXN ILS CLP ARS SAR BRL 52

53 4.3. Country Code - This chart is for reference. Please use the information obtained from TV on the script below. Unity C# Script API & Native API - GSP Linkage is needed to use the below API provided by GSP. (* Detailed GSP guide should be requested through Samsung PM) GSP.GSPSystem.getCountry().ToUpper() Name Code Currency United States of America US USD Canada CA CAD United Kingdom GB GBP Isle of Man IM GBP Guernsey GG GBP Jersey Je GBP France FR EUR Germany DE EUR Italy IT EUR Spain ES EUR Australia AU AUD Turkey TR TRY UAE AE AED Poland PL PLN Switzerland CH CHF Netherland NL EUR Austria AT EUR Belgium BE EUR Luxembourg LU EUR Rumania RO EUR Greece GR EUR 53

54 Sweden SE SEK Ireland IE EUR Bulgaria BG BGN Czech Republic CZ CZK Hungary HU HUF Denmark DK DKK Greenland GL DKK Faroe Islands FO DKK Finland FI EUR Aland Islands AX EUR Norway NO NOK Slovakia SK EUR Russia RU RUB Mexico MX MXN Israel IL ILS Chile CL CLP Argentina AR ARS Saudi Arabia SA SAR Brazil BR BRL 54

55 [Appendix 1 (TV Firmware Check Guide)] In case of asking for inquiries to Samsung regarding TV during development, sharing of the TV firmware version in use greatly assists the identification on the problems The method of identification is as follows. Menu -> Support -> Contact Samsung -> Check Software Version 55