Stash Webhooks
Learn about Stash webhooks - automated notifications sent to your backend when events occur across Stash products. Understand how to configure webhooks in Stash Studio and handle webhook events for player interactions, purchases, and more.
Webhooks are automated notifications that Stash sends to your backend when certain events occur across all Stash products (Webshop, Pay, Launcher). It is a core of integrating any of the Stash products. When an event is triggered—such as a player making a purchase —Stash sends an HTTP POST request (with a JSON payload) to the webhook URL you've configured in Stash Studio.
Common webhook event examples include:
- Player interacts with the item catalog
- Order is paid
- Item is placed in the card
- Subscription is started or renewed
By handling these webhook notifications, your backend can:
- Credit or debit items from a player's account
- Update player balances
- Process refunds
- Grant or revoke subscriptions
- Take action on suspicious activity (e.g., block a user)
The following diagram illustrates the typical payment Stash Pay flow with webhooks:
Configure webhooks
Interactive Demo
To start receiving webhooks, you need to set them up in your Stash Studio project settings:
Open your project
Open your game project in Stash Studio.
Navigate to Settings
Go to the Settings section in the main navigation.
Configure Webhooks
Click on Webhooks.
Here, you can add a new webhook by entering the URL of your webhook listener endpoint. Stash Studio will also provide you with a unique webhook secret, which you should use to verify the signature of each incoming webhook message.
How is this guide?
View Logs in Stash Studio
Learn how to use Stash Studio's comprehensive logging tools to inspect events, debug communication between Stash API and your game backend, and identify integration issues. Access logs for outgoing events, incoming events, payments, and linked accounts.
Webhook List
Comprehensive list of all webhook events that Stash can send to your backend, including event types, triggers, payload structures, and detailed examples for each webhook type across Stash products.