Skip to main content
POST
Create a purchase

Authorizations

Authorization
string
header
required

Use your Project Key from the Qonversion dashboard (Project Settings -> Project Keys -> Project Key).

Production keys have no prefix; keys prefixed with test_ target the sandbox environment.

Example (sandbox): Bearer test_PV77YHL7qnGvsdmpTs7gimsxUvY-Znl2 Example (production): Bearer JFPATc4VaaWYsfurml3qZ4zsmNw0VfWH

Path Parameters

user_id
string
required

Qonversion User ID

Body

application/json
currency
string
required

Three-letter ISO 4217 currency code (case-insensitive; normalised to uppercase server-side)

price
string
required

Monetary amount (decimal string, e.g. "12.99")

purchased
integer<int64>
required

Unix epoch seconds of the transaction

stripe_store_data
object
paddle_store_data
object
app_store_data
object

App Store transaction data. Use only when posting App Store purchases manually instead of via the SDK.

play_store_data
object

Google Play transaction data. Use only when posting Play purchases manually instead of via the SDK.

Response

Purchase created

The response echoes whichever store-data variant was provided in the request: exactly one of stripe_store_data, paddle_store_data, app_store_data, or play_store_data will be present.

user_id
string
required

Qonversion User ID

Example:

"QON_7791a27fc4e747412381842b36a"

currency
string

Three-letter ISO 4217 currency code (uppercase)

Example:

"USD"

price
string

Monetary amount (decimal string)

Example:

"12.99"

purchased
integer<int64>

Unix epoch seconds of the transaction

Example:

1653458781

stripe_store_data
object
paddle_store_data
object
app_store_data
object

App Store transaction data. Echoed only when the purchase was created with app_store_data.

play_store_data
object

Google Play transaction data. Echoed only when the purchase was created with play_store_data.