Purchase Details (ProductV2)

get https://api.catappult.io/productv2/8.20250505/inapp/purchases/{purchase_token}

This API provides the details of Purchase oriented to our ProductV2 Service. It allows you to retrieve detailed information about a Purchase using the purchaseToken. This API is useful to obtain the Order UID of a Purchase which can then be used in other APIs, and also to verify the status of the Purchase. This API does not require authentication.

Show detailed information about the Success (200) result

The Success result returns the following detailed payload:

Name	Type	Description
uid	String	Purchase ID defined as `token` in the Purchase class.
sku	String	SKU of the Product purchased.
domain	String	Package name of the application that originated this Purchase.
type	String	Type of the Product purchased.
status	String	Status of the transaction.
state	String	State of the transaction.
payload	String	String based payload specified by the Developer when initiating this Purchase.
created	String	String based timestamp of the creation date. Eg: `2025-01-14T11:06:31.231117Z`
buyer	Object	Object with information of the Buyer source.
buyer.type	String	Buyer type. Example: `WALLET`
buyer.reference	String	Buyer reference.
order	Object	Object with the information of the Order made in the Payment.
order.uid	String	UID of the Order. Defined as `orderId` in the Purchase class.
order.gateway	String	Gateway of the order. Possible value is `broker`.
order.reference	String	Reference ID of the Order. Defined as `UID` in Aptoide Connect channels.
order.status	String	Status of the Order made.
order.created	String	String based timestamp of the creation date. Eg: `2025-01-14T11:06:31.231117Z`

type

Value	Description
CONSUMABLE	Product type is a Consumable.
SUBSCRIPTION	Product type is a Subscription.

status

Value	Description
PENDING	The purchase is pending one or more actions to be completed. Example: `Consumption`
COMPLETED	The purchase is successfully completed.
VOIDED	The purchase is voided.

state

Value	Description
PENDING	The purchase is pending acknowledgement or consumption.
CONSUMED	The purchase has been consumed.
ACKNOWLEDGED	The purchase has been acknowledged.

order.status

Value	Description
PENDING	The order is pending one or more actions to be completed.
COMPLETED	The order is successfully completed.
FAILED	The order failed to be completed due to an error.
CANCELED	The order is canceled and may no longer be completed.
REFUNDED	The order was refunded.
CHARGEDBACK	The order was chargedback.

Language

Click Try It! to start a request and see the response here!