Stash Webhooks
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
To start receiving webhooks, you need to set them up in your Stash Studio project settings:
- Open your game project in Stash Studio.
- Go to the Settings section in the main navigation.
- 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.