Manage Subscriptions
In-App items are assigned a unique item or product ID. Before or after an item’s purchase, your app can request app-related details about the subscription item using this product ID.
When an in-app item purchase and payment transaction is successful, Samsung IAP assigns a unique purchase ID to the item. Your app server uses this purchase ID to get app-related or user-related details about the subscription.
App-Related details can be requested before or after an item is purchased and include the information you configured for the item in Seller Portal (such as subscription period length, pricing options, availability period, and price).
User-Related details can be requested after an item is purchased and include current details about the user’s subscription (such as the subscription status, current price paid, and number of renewals).
If your app does not receive the purchase ID (for example, due to network issues), you can use getOwnedList() to request it.
The following API calls are used to manage your subscription items (click on the API call to see more detailed information):
-
getOwnedList() (IAP SDK API) – Get a list of items owned by the user that are currently in a free trial or active subscription period. The response is an array of objects (OwnedProductVo). The app can check the availability of a subscription item by referring to the onGetOwnedProducts() data. This API provides meaningful information after an item is purchased. Use this call when the app is launched to determine if the user has successfully subscribed or auto-renewed an item. Subscription items that have been cancelled are included in the response until the active subscription period has ended.
Subscription-related objects include the product ID, purchase ID, current price, purchase date, and current subscription period end date.
-
getProductsDetails() (IAP SDK API) – Get details about a subscription item that was configured in Seller Portal. This call requires the product ID of the subscription item. The response is an array of objects (ProductVo). This API can be called before or after an item is purchased.
Subscription-related objects include the current price, subscription period length, subscription pricing option, availability period, duration of free trial period.
-
iap/v6/receipt (IAP Server API) – Verify a subscription purchase and payment transaction were successfully completed. This call requires the purchase ID of the subscription item. Information is returned in a SOAP response. This API can be called before or after an item is purchased.
Subscription-related content include the subscription identifier, payment transaction identifier, purchase receipt identifier, name of the subscription, description of the subscription, date and time of purchase and payment transaction, total amount billed (includes subscription price and all applicable taxes), and payment transaction status.
-
iap/seller/subscription (IAP Server API) – Get the subscription status, item information, and purchase information, used to verify the purchase of an item. This call requires the purchase ID of the subscription item and a service token for authentication and checks the user’s subscription information on the seller’s back-end server. Information is returned in a REST response. This API provides meaningful information after an item is purchased.
Subscription-related content include the purchase date, current subscription status, current price, current subscription pricing option, number of renewals, paid subscription start date, subscription end date, and reason for cancellation.
For more details about these and other API calls, see the Samsung IAP Programming Guide.
Email receipts
Samsung IAP sends subscription item purchasers emails about significant events:
-
Free trial sign-up email: Sent after initial purchase of an item with a free trial. Contains item product and order information.
-
Subscription purchase email: Sent after initial purchase of an item without a free trial, when a subscription is renewed, and after item repurchases. Contains item product and payment information, including the price paid for the item’s first period of use (for example, a free trial ($0), a lower-tier price, or a regular-tier price).
-
Free trial expiration email: Sent 7 days before the end of a free trial period. Contains item product and subscription information.
-
Subscription renewal email (India customers only): Sent seven (7) days before the end of the subscription period and indicates that their consent is needed to renew the subscription. Details about the steps needed to renew the subscription in Galaxy Store are included. Contains item product and subscription information.
-
Subscription renewal email (all customers, except those in India): Sent near the end of each lower-tier or regular subscription period, which indicates that an auto-payment for the next subscription period will happen soon. Contains item product and subscription information.
-
Subscription cancellation email: Sent after an item is cancelled, either by the user or for another reason. Contains item product information.
Register subscription item
See Register an app and in-app items in Seller Portal in the IAP Programming Guide for more information.
Test subscriptions
See Testing Subscription Items in the IAP Test Guide for more information.