Deprecated APIs are NOT SUPPORTED! The APIs documented on this page are deprecated, should not be used, and are not supported. This documentation is retained for historical and archival purposes only.
Create a service token (SOAP)
Deprecated: End of 2024
createServiceToken generates and returns access token value that your server must use to authenticate getSubscriptionStatus SOAP requests. Each token is valid for 30 days.
NoteIf a token expires during the processing of a SOAP API request, your server must get a new token and resubmit the SOAP API reqeust.
Request
POST
https://iap.samsungapps.com/iap/ws/RTCService?wsdl
(Required) Unique ID (up to 12 numerical digits) assigned by Samsung to each seller Your secret is your Seller DeepLink in Seller Portal (go to your Profile page and scroll to the Information for Seller Page table)
getSubscriptionStatus gets subscription status, item information, and purchase information of a specified Auto Recurring Subscription (ARS) item that was purchased previously.
Request
POST
https://iap.samsungapps.com/iap/ws/RTCService?wsdl
Date and time of the item's initial purchase and payment transaction (YYYY-MM-DD HH:mm:ss GMT)
subscriptionEndDate
String
Date and time of the subscription expiration (YYYY-MM-DD HH:mm:ss GMT)
subscriptionType
String
Type of subscription item Below value is always returned: Item_Type_Auto_Recurring_Subscription
subscriptionStatus
String
Current status of the item subscription "ACTIVE" The subscription is current and in effect. "CANCEL" The user canceled the subscription. Check the subscriptionEndDate to see if the subscription period has ended (as the canceled item is still valid until the current suscription period has ended).
subscriptionFirstPurchaseID
String
Unique identifier of the initial purchase of the item
countryCode
String
Country code (3 alphabetic characters) of the purchaser's location (for example, KOR, USA)
localCurrencyCode
String
Currency code (3 alphabetic characters) of the purchaser's local currency paid for the item (for example, EUR, GBP, USD)
localPrice
double
Cost (in the user's local currency) that the user paid the in-app item price
supplyPrice
double
Total amount of the item price plus the applied tax
itemID
String
Unique identifier of the in-app item registered in Seller Portal
freeTrial
String
Whether or not the in-app item's subscription is currently in a free trial period: "Y" Free trial period "N" Regular price period
realMode
String
For regular purchases, whether the actual payment was made when the user purchased the item. "Y" Samsung IAP was set to production mode. The actual payment was made. "N" Samsung IAP was set to Test Mode. The actual payment was NOT made.
latestOrderId
String
Identifier (19 alphanumeric characters) of the most recent payment. it can be an initial payment or a renewal payment. Order IDs are displayed in the user's renewal receipt.
totalNumberOfTieredPayment
String
Total number of tiered price payments
currentPaymentPlan
String
Current period the subscription is in: - "F" : Free trial period - "R" : Regular price period - "T" : Tiered (lower) price period
totalNumberOfRenewalPayment
String
Total number of payments made for initial and renewal subscriptions
subscriptionFirstPaymentDate
String
Date and time the initial subscription started (YYYY-MM-DD HH:mm:ss GMT)
cancelSubscriptionDate
String
Date and time the subscription was stopped (YYYY-MM-DD HH:mm:ss GMT)
cancelSubscriptionReason
String
Cause of the subscription stoppage: "1" User canceled the subscripton. "2" System canceled the subscription (for example, renewal test was finished). "3" Billing error (for example, user payment information was no longer valid). "4" Item is not available for purchase at the time of renewal. "5" Unknown errors
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.