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.


Application Development Issues

Below you can find a sample email that you can send to us through the TV seller site 1:1 Q&A section.

Figure 1: Click Ask Question and fill out the question

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.

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.

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.

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.

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

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

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

Operation of Your Service

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

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.

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.

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

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.

You will be charged in local currency.

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

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.

Product Type

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

Limited Period

Yes.

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

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

Subscription

SubscriptionInfo is shown only when ItemType is Subscription.

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.

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

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.

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