Managed Catalog
Create and publish Stash Pay products in Stash Studio, then reference them by ID in checkout links. No catalog backend required.
Managed Catalog lets you define Stash Pay products entirely in Stash Studio. Pass a catalogItems list in your checkout link request; Stash resolves the product name, price, and images server-side. No catalog backend or inline item data required.
Managed Catalog is enabled per shop. To enable it for your shop, contact your Stash engineering partner.
Create and publish products
Open the Products section
In Stash Studio, select your game, then navigate to Stash Pay → Products and click Add New Product.
Fill in product details
| Field | Required | Notes |
|---|---|---|
| ID | Yes | Unique identifier. Use this value as the id in catalogItems. |
| Product Name | Yes | Internal name for management. |
| Display Name | Yes | Shown to players at checkout. |
| Product Description | Yes | Shown to players at checkout. |
| Main Image | Yes | Primary product image. |
| Background Image | No | Optional secondary visual. |
| Items | Yes | One or more items the player receives. Set image and quantity per item. |
| Price (USD) | Yes | Player-facing price. Stash Pay is USD only. |
Publish
Products start as Draft. Once all required fields are set, click Publish. Only published products can be resolved in checkout links.
Reference products in a checkout link
Pass catalogItems instead of item in your GenerateQuickPayUrl request. Each entry references a published product by its ID and the quantity being purchased.
{
"catalogItems": [
{
"id": "starter-pack-usd",
"quantity": 1
}
],
"user": {
"id": "player-123",
"displayName": "Player One",
"platform": "IOS"
},
"transactionId": "txn-abc-001"
}catalogItems parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Product ID as set in Stash Studio. Must match a published product. |
quantity | number | Number of units to purchase. |
catalogItems and item are mutually exclusive. Providing both returns a 400 Bad Request. You must provide exactly one.
If managed catalog is not enabled for your shop, the request returns FAILED_PRECONDITION. Contact your Stash engineering partner to enable it.
Test with the Link Generator
When managed catalog is enabled for your shop, the Link Generator in Stash Studio shows a Product dropdown in the item section. Select any published product to generate a test checkout link using catalogItems. No manual JSON required.
How is this guide?