Samsung Checkout Q&A

This topic solves various issues you may face while creating applications that use Samsung Checkout service. Select the applicable section to see the most common questions about a specific subject, and click the section heading to access all the available questions for that subject.

Before Submitting Your Application for Samsung Software Quality Assurance (SQA)


There are a few mistakes that are frequently made by the developer, check the list below to ensure that you followed the process correctly.

  1. Check that you have registered your product for the Operating zone from the DPI portal. Your product needs to be registered in both Staging and Operating zones.

  2. Ensure that the application detects the service environment and sets the DPI API URL and server type accordingly. You can find more information under "Prerequisites > 4.Initialize the required variables > 4.4 Set the DPI URL and service environment depending on the server type" section in Implementing the Purchase Process.

TV

Application Development Issues


Below you can find a sample email that you can send to us through the Samsung Apps TV Seller Office 1:1 Q&A section.

Figure 1: Click Ask Question and fill out the question

TV

The "MD" at the end is the Country Code for "MD: Moldova, Republic of", which is not a supported country for the Samsung Checkout service. To see all the list of country where Samsung Checkout is supported, go to the "Country and Currency Codes" section in Implementing the Purchase Process.

TV

Yes, you can use the information below in your test application to see how Samsung Checkout client works on the TV. Before using this information, set your TV's country setting to a supported country like the US. In addition, make sure that the test information is only used at the development stage before setting up your own DPI, it must not be used in any real service.

Parameter value
appID 3201504002021
paymentServer DEV
paymentDetails OrderItemID DP111000001962
OrderTitle 0708_Consumable
OrderTotal 1.5
OrderCurrencyID USD

Table 1. buyItem() method request parameters

Sample code:

var appId = "3201504002021";
var paymentServer = "DEV";

var detailObj = new Object();

detailObj.OrderItemID = "DP111000001962";
detailObj.OrderTitle = "0708_Consumable";
detailObj.OrderTotal = "1.5";
detailObj.OrderCurrencyID = "USD";
detailObj.OrderCustomID = "";

var paymentDetails = JSON.stringify(detailObj);

var onsuccess = function(data) {
};

var onerror = function(error) {
};

webapis.billing.buyItem(appId, paymentServer, paymentDetails, onsuccess, onerror);

TV

Yes. The response for "invoice/list" does not consider the country code of the API request parameter, it returns all of the purchases what the buyer has purchased regardless of country.

TV

Yes, below is the minimum checklist for integration with Samsung Checkout, you can test each item in the checklist to make sure your application works properly.

  1. When purchasing the product

    1. When the Samsung Checkout client is launched, it shows the loading by itself, no graphical overlapping should exist in user experiences during the transition. For example, a 3rd party application should not show loading when launching the Samsung Checkout client.
  2. Check the purchase process based on the type of product

    1. Consumable/Dynamic Item type: The user should be able to use the appropriate payment method to buy the item, and the title and price on the purchase page should be same as intended.
    2. Subscription/Free Trial Item type: In addition to the above, the user should be able to see the next payment date or relevant information of the subscription item.
  3. Check the post-purchase process in the 3rd party application

    1. Does the 3rd party application reflect the result of a purchase in the application properly after completing the purchase process? Both the SUCCESS case for a purchase and other cases should be handled.
    2. Is there any overlap when screen is switched from the Samsung Checkout client to the 3rd party application?
  4. Check the purchase history based on the type of product (go to the "TV menu > Samsung Account > Payment info" to see the subscription or purchase history)

    1. The user needs to be able to check the purchase history (or subscriptions) of the item.
    2. The user needs to be able to check subscription details.
  5. Check the user purchase history from the User buyer portal to make sure the history is properly updated

    1. After making a purchase, go to the Samsung Checkout website and check whether your status is updated properly.
  6. Test for exceptions

    1. Turn off the TV while the purchase is in progress and checks if any inappropriate status is observed. For example, go to the "TV menu > Samsung Account > Payment info" to see the subscriptions or purchase history.
    2. After completing the purchase of the item, turn the TV off and on again and run the 3rd party application to see if the previous purchase is still in active status.

TV

DPI Portal Usage Guide

From the DPI portal, partners can register and manage products for sale and access the transaction history logs and sales reports for the applications they own.

If you want to change the price of an existing item, go to the DPI site and select "App > Product List (on the left side) > Product ID". From there, you can change the product price. For countries where it is necessary to select a tax category, you need permission from the Samsung administrator to change the price. Prices you set can be changed after three months and you must notify the consumers of the new price.

TV

When a buyer purchases a specific product which is sold in multiple countries, they have the right to access any of those versions. Therefore, if you want to give a right for the purchase only within a single country, you need to register products separately for each country (the Product ID needs to be different).

TV

This is correct, security keys are bound to the appId.

TV

When you enroll your application on the seller site, you need to check the appropriate options for using Samsung Checkout. Refer to the picture below.

Figure 2: Select "Use" and "Yes" to use Samsung Checkout DPI site

TV

For the Staging zone (Development), approval takes a maximum of 2 days. For the Operating zone, contract terms and conditions need to be finalized between you and Samsung before approval can be granted.

TV

Operation of Your Service

This section explains the issues related to the operation of your service.

No, Samsung Checkout service is available on only Samsung Smart TVs.

HTV

Yes, Samsung Checkout service is available since the 2016 Samsung Smart TV range. However, the latest features are guaranteed to function only for the last three years, and there may be a difference in the functionality of each year.

TV

Samsung sends an e-mail to users who buy items, subscribe, cancel, and refund. In addition, Samsung sends a notice e-mail to users whose subscription item payment has failed.

TV

Yes, you can find additional information at the following page: DPI > Support > Error Code.

TV

No. The service provider must relay this information to the buyers before the changes are made, because Samsung Checkout does not send price change notifications to buyers who subscribe to subscription products.

TV

You will be charged in local currency.

TV

"CustomID" and "OrderCustomID" have the same value. "CustomID" also uses the same value as "OrderCustomID" when calling buyItem(). If you have a Unique ID, use it. If not, use the Samsung Account UID.

TV

This is done using "OrderCustomID". If the provider has a user account, they can put the value in the "OrderCustomID" parameter when calling the buyItem() API. This value is mapped to the Transaction List's "Order Custom ID" column.

TV

Product Type

This section includes information related to product types that can be purchased using the Samsung Checkout service.

Limited Period


Yes.

TV

No, LimitEndTime must exist when a Limited Period product is applied.

TV

Correct. LimitEndTime is calculated based on the date and time when the purchase is applied.

TV

Subscription


SubscriptionInfo is shown only when ItemType is Subscription.

TV

The InvoiceID is generated when the buyer subscribes to a product for regular payment. However, SubscriptionId is generated only when the buyer subscribes a product for the first time. Samsung Checkout uses the first InvoiceID as the SubscriptionId and it is never updated.

TV

No, the subscription end date (SubsEndTime) describes the expiry time of this subscription (not NextPaymentTime).

TV

Calendar month. The next month's payment is made on the same day of the month as the day the consumer first applied for the subscription.

For example, if the consumer applied for a subscription on November 14th, the next payment is made on December 14th. For months that don't have a day corresponding to the settlement date (such as the 31st), payment is made at the end of the month.

TV

No. Even if the consumer withdraws their Samsung Account or cancels a subscription to the regular payment, this does not refund any payments already charged.

On the next settlement date, the subscription status is changed from 'active' to 'expired', and regular payment is stopped.

Figure 3: Billing subscription process

TV