Samsung Checkout DPI Portal

Overview

The Samsung Checkout DPI (Digital Product Inventory) Portal(https://dpi.samsungcheckout.com/) is a web service portal designed for the Samsung Smart TV partners, which Samsung helps them sell products and items through Smart TV Apps. From the DPI, partners can register and manage products for sale and access the transaction history logs and sales reports for the applications they own.

DPI Main Services

Product management (Standard in-app products, Subscriptions, Paid apps)
Order management (purchase history for each user)
Sales reports and financial reports
Coupon management (creation and issuance)

Service Initiation Process

Figure 1. Service Initiation Flow
An account for the Samsung Apps TV Seller Office is required to use the DPI service. Once registered, partners can use the DPI service

※ DPI Mini Guide helps to grasp the overall workflow of Samsung Checkout service and DPI site :
- Mini Guide Download

Step 1 : Accessing Samsung Checkout - Login

Create a Samsung account. Register your app in Seller Office and login to the DPI.

① Create a Samsung Account

② Register your app in Seller Office

③ Login to the Checkout DPI portal

Figure 2. Membership Management menu

Notice

At first, only 'Manager' in seller office can access DPI Portal.

Manager can manage entire menu in DPI Portal
Manager can give permission to 'Members' through Membership Management
※ Members cannot access main screen before being given permission by a manager.

Step 2 : Create Group and Give Permissions

Only managers can access the member menu and manage groups.
Figure 3. Create Group with configuration
① Member Menu
Managers can manage and give menu permissions to members. This can be done through the Membership Management and the Group Management menus.

② Group Management > Click Create Group
Go to Create Group menu and configure a group.
You can click Operation, Finance, CS or Developer buttons to show preset menu permissions. These preset menu permissions are for guidance only and can be edited.

③ View Group Management List
Now you can manage members.
Go to ‘Membership Management > Edit Permissions’ menu

Figure 4. Menu permission
④ Membership Management > Edit Permissions
Managers can manage and give menu permissions to members. This can be done through the Membership Management and the Group Management menus.

⑤ Select member and group
Go to Create Group menu and configure a group.
You can click Operation, Finance, CS or Developer buttons to show preset menu permissions. These preset menu permissions are for guidance only and can be edited.

⑥ Confirm permissions
Now you can manage members.
Go to ‘Membership Management > Edit Permissions’ menu

Step 3 : Issuance of DPI Security Key

The DPI security key must be issued to safely use the service. The issued key can be viewed under 'Settings > App Details 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 Generating Check Values.

Figure 5. Security Key Issuance

ImportantThe 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.

Test Buyers

You can enroll test buyer in Settings > Test Buyer menu. Checkout does not provide dummy pay anymore.
Therefore, If you’d like to do payment test, please enroll test buyer.
Figure 6. Test buyer registration
① Input the test buyer’s Samsung Account ID. Click [Check Samsung Account Registration] and please check the Samsung account is available.
② Input the test buyer’s name
③ Contact is not required information. After filling in all the required information, Click [Register] button.

NoticeBefore launching your app on TV, Only test buyers are allowed to proceed with the payment test.

ImportantAfter releasing your app on TV, everyone is free to proceed with the payment test.
※ After the test, you must manually process the refund. It does not provide an automatic refund function.

Product

Products can be registered for different countries through the Add a New Product menu.

Configure Product

Figure 7. Product Configuration
① Go to ‘Product > Add a New Product’ menu.
② This is where a new product is registered.
③ Enter product information (Product ID, Description, Product Type, Visibility, Expiration).
④ Please note that when you check visibility, the product will become visible from the app.

Product Type

The following table explains the details of "Product Type".

Product Type	Description
Consumable	Consumers can purchase this type of product anytime. Purchase history can be retrieved for 90 days.
Non-Consumable	Consumers can purchase this type of product only once. Purchase history can be retrieved with no time restriction.
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.
Subscription	DPI system processes automatic payment on a certain designated cycle.
Paid App	For paid apps, when you register your app on DPI system you need to select it as paid app.
Dynamic Product	In case that pater and Samsung agree on that products and prices will be managed by CMS of partner not Samsung’s DPI, partner should select “Dynamic Product” as a product type. Even though all the information of actual products are on CMS, partner need to register a representative item on DPI once so that our system can display information on Samsung Smart TV App/Game store which is legally required and verify which server we need to call for certain products : CMS or DPI. If Dynamic Product is chosen, Partner does not register each products on DPI that partner sells in their app actually Partner builds and operates its own CMS to manage products information including prices and to verify purchase requests Additional requirements Verification/No Verification: ‘Verification’ is a recommended option otherwise partner has to handle the verification process by themselves and take all the responsibility for all the error cases related to verification process. If ‘Verification’ is selected, ‘Verify URI’ is also required. This URI should serve the function of checking product information such as product itself, price and currency Price Setting Price range information of products that you actually sells in your app is required by country/location. It is not used for actual payment for providing the app information on Samsung Smart TV App/Game store which is legally required. Thus, it has to be updated when the price range of your products is changed.

Subscription

It is necessary to make a subscription group before creating subscription item.

Figure 8. Subscription Group Configuration

Add New Subscription Group

① Go to ‘Product > Subscription Group > Add a New Group’ menu.
② This is where a new subscription group is registered.
③ Enter Subscription Group name

Setting free trial offering

① Free trial is able to set per “Product group” ID.
② Partner defines whether a free days offer whether it should be offered once per account/device or both.

Notice [Free trial offering Option]
Per Account only once: If a user use a free trial offer with the "A" Account once, free experience will be expired, and additional free experience is not possible with the "A" Account. However, if a CP does not check “ Per Device only once ”, a user can experience it free of charge when creating a new account with no subscription history.
Per Device only once: If a user use one free trial offer on "A" device, a user cannot use free experience even if you change your account and create a new "B" account on A device.
Both- Per Account Only once: Provide free trial offer both based on “ A ” Account and “ A ” Device.
Case 1) With the “ B ” account that does not have a subscription history, free experience is not available when you first sign up for the “ A ” device.
Case 2) With “ A ” Account, which has a history of cancellation after subscription, “ B ” Device subscription is not allowed for free

Figure 9. Configure Subscription in Product Type

Configure subscription

① Go to ‘Product > Add a New Product’ menu.
② Select subscription in the product type.
③ Enter product information (Product ID, Description)
④ Choose Billing Period, Produce Level, Subscription Group
⑤ If you’d like to make free trial subscription, please input the free trial period.
⑥ Check the Duplicate Benefit, Visibility, Expiration.

Subscription Plan

Checkout supports upgrade, downgrade, cross-downgrade subscription plan.

Figure 3. Supscription Plan

Create a subscription group to set the subscription level.
In the same group, consumers can upgrade and downgrade freely.
Cross-downgrade API is currently possible,
Checkout does not provide Cross-upgrade API.

ImportantIf you’d like to use the Cross-upgrade function, please use a combination of Upgrade API and Cross grade API. Please refer to the details on the SDF site. (In the near future, we will provide the guide on the SDF site.)

Field Description

The following table explains the details of input fields.

Input Field	Description
Product Name (Representative product name)	The name of the product used in the representative country/location must be entered in the Country/Location:Product Name field. This field cannot be left empty.
Product ID	Alphanumeric and two special characters ('-', '_') are allowed. (Maximum 20 bytes)
Product Description	Describe the product.
Type	Following product types are allowed; Consumable, Non-Consumable, Limited Period, Paid App, Subscription, Dynamic Product
Period	If the product type is ‘Limited Period’, a number fewer than 129,600 in minutes is allowed. (Maximum 90 days)
Billing Period	If the product type is "Subscription" , "Weekly","Monthly","Annualy" is allowed.
Subscription Group	It is necessary to make a subscription group before creating subscription item.
Free Trial Period	If the product type is "Subscription", a number in Days is allowed.
Visibility	A field indicating whether the product can be shown. "Show" , "Hide" and "Optional" is allowed.
Duplication Benefit	The condition defines whether a free days offer whether it should be offered once per account/device or both.
Expiration	If the product type is "Subscription" , "Not Applicable" ,"1 Month", "6 Month", "1 Year" is allowed.
Country/Location:Product Name	The country/location and product name are separated by ':' and a maximum of 50 bytes of product name is allowed. If more than one country/location is entered, use '
Country/Location:Product Price	The country/location and price information are separated by ':', and if more than one country/location is input, the use of the '

Transaction Policy

The 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.

Product Type	Applied Purchases (Purchase History)	Not Applied Purchases	Refund/ Cancellation
Consumable	Application Date + 90days	All products can be viewed with no restrictions in time period	Refund Date+ 90 days
Subscription	Subscription expiry date (SubsEndTime) + 90days	Subscription expiry date (SubsEndTime) + 90 days	Subscription expiry date (SubsEndTime) + 90 days

Glossaries

Term	Description
Billing / Payment Service	A service created in order to help monetary transactions between service providers and users.
Partner / App Developer	Be in charge of creating products suitable for consumers of the Smart TV.
Paid App	A service or app that can be only downloaded after making a payment.
In-App Purchase	A method to pay for additional products and features within both free apps and paid apps.
PayPal (PayPal)	The global payments company headquartered in the United States that provide the payment service via pre-registered payment method.
Digital Product Inventory (DPI)	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.
Samsung Checkout (Billing Client)	A payment UI module for consumers to add their choice of payment methods and pay for premium apps or special items.
Operating Zone/ Staging Zone	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 / Development TV	- 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.
CMS (Content Management System)	Product catalogue management server or system including price information. In this document, this word refers to the server for the type “dynamic product” that has all the information of products and handles verification with its own product catalogue. For reference, product information of other product types should be managed in DPI not 3rd party CMS. DPI will be looking at CMS to pull necessary product information as needed. CMS will be the source of truth regarding content metadata, purchase history (which user bought which title at which resolution of PURCHASE/RENTAL, etc.) whereas DPI will be the source of truth of transactional data (i.e. transaction amount, tax amount). Both systems will be linked by "invoice ID" that is generated by DPI and passed over to CMS for every successful transaction.

※ DPI User Guide Full Version provides detailed desciptions and examples of New DPI site functions/usages.
- Full Guide Download