---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Store purchases"
description: "The `store_purchases` collection of Sylphx Money: A Store Purchase is one store transaction Money verified with the store and bound to one subject."
type: reference
product: purchases
summary: "A Store Purchase is one store transaction Money verified with the store and bound to one subject."
updated: 2026-09-28
order: 900
---

A Store Purchase is one store transaction Money verified with the store and bound to one subject. Re-verifying it returns the same record and grant.

**Service** Sylphx Money · **Resource type** `money.sylphx.com/StorePurchase` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/store_purchases/{store_purchase}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/store_purchases/{store_purchase}`. |
| `uid` | `string` | `spu_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `subject` | `Subject` | Who it belongs to. Output only. |
| `store` | `string` | `app_store` or `google_play`. Output only. |
| `product_id` | `string` | The store product id. Output only. |
| `product` | `string` | The catalog product it sells, when the catalog maps the store product. Output only. |
| `bundle_or_package` | `string` | The bundle id or package name. Output only. |
| `transaction_id` | `string` | The store's transaction id (App Store transaction id, Play order id). Output only. |
| `original_transaction_id` | `string` | The first transaction of a subscription or restored purchase. Output only. |
| `quantity` | `int32` | Units bought. Output only. |
| `environment` | `string` | `production` or `sandbox`. Output only. |
| `state` | `string` | `purchased`, `pending`, or `revoked`. Output only. |
| `purchase_time` | `timestamp` | When the store says it was bought. Output only. |
| `revoke_time` | `timestamp` | When the store refunded or revoked it. Output only. |
| `price` | `string` | The price the store charged, in minor units of `currency`, when the store reports it. Output only. |
| `currency_code` | `string` | ISO 4217 currency of `price`. Output only. |
| `customer_subscription` | `string` | The subscription it belongs to, for a subscription purchase. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `POST` | [`verify`](/docs/api/store_purchases#verify) | Verifies a store purchase with the store, binds it to the subject, and returns its record and a signed grant. Re-verifying returns the same record and grant. Called from the app's server with a secret key that holds `billing:write`; a publishable key cannot call it. |
| `GET` | [`get`](/docs/api/store_purchases#get) | Gets a store purchase. |
| `GET` | [`list`](/docs/api/store_purchases#list) | Lists store purchases, newest first. |

## verify

Verifies a store purchase with the store, binds it to the subject, and returns its record and a signed grant. Re-verifying returns the same record and grant. Called from the app's server with a secret key that holds `billing:write`; a publishable key cannot call it.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/store_purchases:verify` · scope `billing:write` · effect `write` · [Request, response and examples](/docs/api/store_purchases/verify)

## get

Gets a store purchase.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/store_purchases/store-purchase` · scope `billing:read` · effect `read` · [Request, response and examples](/docs/api/store_purchases/get)

## list

Lists store purchases, newest first.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/store_purchases` · scope `billing:read` · effect `read` · paginated · [Request, response and examples](/docs/api/store_purchases/list)