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?