Skip to main content
Samsung Developer Program

IAP Server-to-Server API Reference

Server-to-server purchase verification allows your service app server to verify the validity of a purchase, which reduces malicious purchases.

 

https://<IAP URL>/appsItemVerifyIAPReceipt.as

Gets the IAP server to verify the IAP purchase and payment processing of an item specified by its purchase ID.

As a result of an IAP purchase request, a purchaseId is returned to your service app. In third-party client service apps, the purchaseId is sent to your server. Your service app server can request verification of the purchase via an HTTP request to the verifyUrl that contains the purchaseId value.

Request Parameters

protocolVersion

String

Version number of the IAP implemented at the time of purchase.

purchaseID

String

Product purchase identifier assigned by IAP at the time of purchase and returned to the requesting service app.

Example Request
https://iap.samsungapps.com/iap/appsItemVerifyIAPReceipt.as
?protocolVersion=2.0
&purchaseID=d215d9abcd17b12578a21c0ea7d8821747b64939732a3243b538d8bcae245590
Return Parameters

itemId

String

Unique identifier of the commercial product.

itemName

String

Brief descriptive name of the commercial product.

itemDesc

String

Description of the commercial product.

paymentId

String

Payment identifier of the most recent user purchase of the commercial product.

purchaseDate

String

Purchase date (in milliseconds) of the commercial product.

paymentAmount

String

Total payment amount.

status

String

Validity test results of the most recent user purchase of the commercial product.

paymentMethod

String

Type of payment option used to purchase the product.

mode

String

IAP operating mode in effect at the time of purchase.

Example Returns

The IAP server returns verification results in JSON format.

When a purchase is valid:

 {
    "itemId" : "57515",
    "paymentId":"ZPMTID20131122GBI0015292",
    "itemName":"Test Pack",
    "itemDesc":"IAP Test Item. Best value!",
    "purchaseDate":"2013-11-22 04:22:36",
    "paymentAmount":"9.000",
    "status":"true",
    "paymentMethod":"CreditCard",
    "mode":"REAL",
 }

When a purchase is not valid:

 {"status":"false"}
  • Was this article helpful?