The Samsung In-App Purchase (IAP) Instant Server Notification (ISN) contains registered and private claims.
Because event types and content within the payload is continually added (content that already exists is not deleted), handling the notifications that are sent to your server requires some flexibility.
The payload is encoded in base64 format. When it is decoded, it is in JSON format.
The following events are reported in the notification and are explained in the Data Claims section below:
The purchase ID you used with the receipt verification API.
testPayYn
string
Y: The item was purchased by a licensed tester in IAP test mode. N: The item was purchased in IAP production mode. See IAP test mode conditions for more information.
betaTestYn
string
Y: The item was purchased during a closed beta test. N: The item was not purchased during a closed beta test. See IAP test mode conditions for more information.
passThroughParam
string
Transaction ID you created as a security enhancement when requesting a payment, and is delivered only when entered when requesting a payment.
The purchase ID you used with the receipt verification API.
testPayYn
string
Y: The item was purchased by a licensed tester in IAP test mode. N: The item was purchased in IAP production mode. See IAP test mode conditions for more information.
betaTestYn
string
Y: The item was purchased during a closed beta test. N: The item was not purchased during a closed beta test. See IAP test mode conditions for more information.
The purchase ID you used with the receipt verification API.
paymentPlan
string
Product plan applied to the current user (for example, FreeTrial / TieredPrice / Regular).
scheduledTimeOfRenewal
number
The next subscription renewal date, in Unix epoch time.
testPayYn
string
Y: The item was purchased by a licensed tester in IAP test mode. N: The item was purchased in IAP production mode. See IAP test mode conditions for more information.
betaTestYn
string
Y: The item was purchased during a closed beta test. N: The item was not purchased during a closed beta test. See IAP test mode conditions for more information.
Subscription ended
The subscription has ended or is cancelled and is not renewed. The subscription is still available until the end of the current subscription period.
The order ID on the first receipt delivered to the subscriber.
firstPurchaseId
string
The purchase ID you used with the receipt verification API.
testPayYn
string
Y: The item was purchased by a licensed tester in IAP test mode. N: The item was purchased in IAP production mode. See IAP test mode conditions for more information.
betaTestYn
string
Y: The item was purchased during a closed beta test. N: The item was not purchased during a closed beta test. See IAP test mode conditions for more information.
validUntil
number
The subscription expiration date, in Unix epoch time.
Subscription refunded
The subscription payment, at any point during the current subscription period, is refunded to the subscriber.
The order ID on the first receipt delivered to the subscriber.
firstPurchaseId
string
The purchase ID you used with the receipt verification API.
refundedOrderId
string
The order ID of the refunded payment.
refundedPurchaseId
string
The purchase ID of the refunded payment.
refundedPurchaseDate
number
The purchase date of the refunded payment, in Unix epoch time.
testPayYn
string
Y: The item was purchased by a licensed tester in IAP test mode. N: The item was purchased in IAP production mode. See IAP test mode conditions for more information.
betaTestYn
string
Y: The item was purchased during a closed beta test. N: The item was not purchased during a closed beta test. See IAP test mode conditions for more information.
Subscription renewed
The subscription has been renewed by the subscriber.
The order ID on the first receipt delivered to the subscriber.
firstPurchaseId
string
The purchase ID you used with the receipt verification API.
renewedOrderId
string
The order ID of the most recent renewal payment.
renewedPurchaseId
string
The purchase ID of the most recent renewal payment.
paymentPlan
string
The product plan applied to the current subscriber (for example, FreeTrial / TieredPrice / Regular).
scheduledTimeOfRenewal
number
The next subscription renewal date, in Unix epoch time.
testPayYn
string
Y: The item was purchased by a licensed tester in IAP test mode. N: The item was purchased in IAP production mode. See IAP test mode conditions for more information.
betaTestYn
string
Y: The item was purchased during a closed beta test. N: The item was not purchased during a closed beta test. See IAP test mode conditions for more information.
Subscription price change accepted
The subscriber has consented or not consented to a subscription price change.
The order ID on the first receipt delivered to the subscriber.
firstPurchaseId
string
The purchase ID you used with the receipt verification API.
agreeYn
string
Y: The subscriber consented to the subscription price increase and the subscription will be renewed at the increased price at the beginning of the subscription period when the price increase is applied.. N: The subscriber did not consent to the subscription price increase and the subscription will be cancelled at the end of the final subscription period that charges the current price.
testPayYn
string
Y: The item was purchased by a licensed tester in IAP test mode. N: The item was purchased in IAP production mode. See IAP test mode conditions for more information.
betaTestYn
string
Y: The item was purchased during a closed beta test. N: The item was not purchased during a closed beta test. See IAP test mode conditions for more information.
Order history deleted
Delete order details. When the order details are deleted, receipt and subscription information for the specified order and purchase IDs are no longer available.
The following table describes the conditions (status of content in Seller Portal and the IAP operating mode) that apply for the testPayYn and betaTestYn property values.
Content Status in Seller Portal
Registering (with licensed tester)
Closed beta
For Sale
IAP Operating Mode
OPERATION_MODE_TEST
OPERATION_MODE_PRODUCTION
testPayYn
Y
N
betaTestYn
N
Y
N
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.