[GET] In-App Purchase Verification

This API allows you to verify the credibility of an in-app purchase. It is useful for a final verification before delivering the item to the user, ensuring the purchase is correct and preventing fraud. This API does not require authentication.

Endpoint

Method	URL
GET	https://api.catappult.io/productv2/8.20250505/google/inapp/v3/applications/{packageName}/purchases/products/{sku}/tokens/{purchaseToken}

Authentication

No authentication required.

Path Parameters

Parameter	Type	Required	Description
packageName	string	Required	Package name of the application.
sku	string	Required	The SKU associated to the purchase.
purchaseToken	string	Required	Purchase ID defined as token in the Purchase class of the SDK.

Response

Status	Description
200	Success. Returns the purchase details.

Success (200) Response Fields

Name	Type	Description
kind	String	Represents a productPurchase.
purchaseTimeMillis	String	The time the product was purchased in milliseconds.
purchaseState	Integer	The purchase state of the order.
consumptionState	Integer	The consumption state of the in-app product.
developerPayload	String	A developer-specified string that contains supplemental information about an order.
orderId	String	The order id associated with the purchase of the in-app product.
acknowledgementState	Integer	The acknowledgment state of the in-app product.
purchaseToken	String	The token provided to the user's device when the product was purchased.
productId	String	The product ID of the product being purchased.
regionCode	String	The region code for the place where the purchase was made.
currency	String	The price currency, as an ISO 4217 alphabetic code. Example: USD

Example Response

{
    "kind": "androidpublisher#inappPurchase",
    "purchaseTimeMillis": "1741713309325",
    "purchaseState": 0,
    "consumptionState": 1,
    "developerPayload": "f54bedc1-65b3-4aa0-a3af-1c0eacc49bf7",
    "orderId": "Z3LGN5Q7HWR4EYNM",
    "acknowledgementState": 1,
    "purchaseToken": "catappult.inapp.purchase.B3TSKHOTY55JQFKS",
    "productId": "attempts",
    "regionCode": "PT",
    "currency": "EUR"
}

purchaseState

Value	Description
0	The purchase is successfully completed.
1	The purchase has been cancelled.

consumptionState

Value	Description
0	The purchase is pending consumption.
1	The purchase has been consumed.

acknowledgementState

Value	Description
0	The purchase is pending acknowledgement.
1	The purchase has been acknowledged.