The Samsung In-App Purchase (IAP) Orders API is used to view all payments and refunds on a specific date. Before you can start using the IAP Orders API, you must meet all requirements and use the required authorization header parameters in your requests. See Get Started with the IAP APIs for more information.
View payments and refunds
View all payments and refunds on a specific date.
Request
POST /iap/seller/orders
Name
Type
Description
sellerSeq
string
Required. Your seller deeplink in Seller Portal, a 12-digit number.
Optional. The package name of the app for which you want to view payment and refund data. If no packageName is specified, data is returned for all apps.
To find an app's package name, log in to Seller Portal, go to Apps, select the app, open the Binary tab, and click the file name.
requestDate
string
Optional. The specific day for which you want to view payments and refunds. If no date is specified, yesterday's date is used.
Format: yyyymmdd
continuationToken
string
Optional. Request the next page of payment/refund data (a page contains up to 100 items). If a continuationToken is not specified, the first page of data is displayed.
If more than one page of data is available, the response includes a continuationToken. Use this token to request the next page of data. If the continuationToken returned in the response is null, this means the previous page of data is the last page to contain item information.
Yesterday's payments and refunds for the specified app.
sellerSeq, requestDate
Payments and refunds for all apps for the specified date.
sellerSeq, packageName, requestDate
Payments and refunds for the specified app and the specified date.
Response
Parameters
Name
Type
Description
continuationToken
string
If more than 1 page of data (100 items) is available to view, a continuationToken is sent in order to request and view the next page of data. If the continuationToken is null, this means the previous page of data is the last page to contain item information.
orderId
string
Unique identifier assigned to the purchase receipt.
purchaseId
string
Unique identifier of the in-app item purchase transaction.
contentId
string
Content ID of the application registered in Seller Portal.
countryId
string
Three-character country code (ISO 3166) of the country where the item is sold.
packageName
string
Package name of the application registered in Seller Portal.
itemId
string
Unique identifier of the in-app item registered in Seller Portal.
itemTitle
string
Title of the in-app item registered in Seller Portal.
If you want to test the "Payment canceled" status, contact customer support at Seller Portal > Help > Contact us > Contact us at the Customer Center. Include the orderId of the purchase so that we can change the order status to "Payment canceled."
orderTime
datetime
Timestamp (UTC) when the order was requested.
completionTime
datetime
Timestamp (UTC) when the payment was successfully completed.
refundTime
datetime
Timestamp (UTC) when the payment was canceled by the admin.
localCurrency
string
Currency symbol of the country's currency where the item was purchased (for example, $).
localCurrencyCode
string
Three-character currency code (ISO 4217) of the country's currency where the item was purchased (for example, EUR, GBP, USD).
localPrice
string
Price of the item in the country where the item was purchased.
usdPrice
string
Price in U.S. dollars (USD).
exchangeRate
string
USD exchange rate at the time of purchase.
mcc
string
SIM card country code.
subscriptionOrderId
string
If the purchased item is a subscription, the origin order ID of the subscription.
freeTrialYN
string
If the item is purchased during a free trial period.
Y: The item was purchased during a free trial period. N: The item was not purchased during a free trial period.
tieredSubscriptionYN
string
If the item is purchased as a lower-tier/introductory or regular-tier/regular subscription.
Y: The item was purchased as a lower-tier or introductory subscription. N: The item was purchased as a regular-tier or regular subscription.
The following are response codes you may see when the request fails.
Status
Code and message
400 Bad Request
SLR_4001: Seller is not matched
SLR_4009: Continuation token is invalid
SLR_4010: Decrypted continuation token consists of invalid data type
SLR_4011: Date format is invalid. Use the format yyyymmdd
401 Unauthorized
SLR_4008: Failed to verify gateway server authorization
Manage Your Cookies
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.