Awesome
Note: This repository is currently being updated, and a version with recent updates from steam will be available shortly.
Steam Microtransaction Bridge API
An intermediate API to handle Steam microtransactions (In-Game Purchases) using Steam web services.
You can use this repo to fork and host an API to be used with Unity, Unreal, Godot, or any engine you want to develop a Steam game.
READ BEFORE USE
This Bridge API has been created based on the Steam Partner API recommendations.
If you need to implement microtransactions in your game, you must create a web service to handle and request the Steam WEB API, and that's precisely the purpose of this repository.
To help game developers save time and money, I've created a single codebase that enables them to implement microtransactions quickly.
With this repository, you can use Heroku or DigitalOcean to deploy your own API with just a few clicks. See Heroku Git Deploy or DigitalOcean Deploy, or choose any other host you prefer.
WHY DO I NEED TO USE THIS REPO OR CREATE MY OWN? CAN I MAKE REQUESTS DIRECTLY FROM MY GAME?
First of all, it's important to read Steam's recommendations on this topic: https://partner.steamgames.com/doc/features/microtransactions
Steam doesn't recommend calling the Steam Partner API directly from your game. Instead, you should create your own API to act as a bridge between your game and Steam. That's the purpose of this API repository.
HOW TO START THE API?
This is a TypeScript (Node.js v18+) based API, and you can use services like Heroku or DigitalOcean to publish it.
To get started, follow these steps:
- Install Node.js v18+.
- Clone or fork this repository.
- Generate your Steam WEB API key.
To run the API locally and for testing, duplicate the file env.example
and rename it to .env
, and then update it with the correct values.
- Run
yarn
to install the dependencies. - To test if everything is working, run
yarn test
. - To start the application, run
yarn start
.
CONFUSION ABOUT WEB API KEY GENERATION FOR STEAM IN-APP PURCHASES
There is some confusion about which web key to use for Steam in-app purchases and in-game API integration. Here are the instructions for generating the correct key:
- Go to the Steam Developer Page.
- Click on the "Menu" button, and then select "User & Permissions."
- Click on "Manage Groups" and select your app's name.
- On the sidebar, you'll see a link that says "Generate WebAPI Key." Click on that link to generate the proper key.
LIST OF PRODUCTS
To prevent users from sending arbitrary amounts for products, there is a file called products.json
in the src/
directory. Make sure to replace the ID and amount according to your list of products.
INTEGRATING WITH YOUR GAME
You can check the documentation of this API here: https://jasielmacedo.github.io/steam-microtransaction-api/
The flow is as follows:
- The user (player) clicks on the UI product.
- Your game calls the
/InitPurchase
endpoint to start the purchase. - The game will display a confirmation dialog (inside the game).
- The user buys the item (pays for it).
- The game receives a callback confirmation about the purchase.
- Your game calls the
/FinalizePurchase
endpoint. - That's it.
If the user has parental control and the callback was not called, you can check the status by calling the /CheckPurchaseStatus
endpoint.
SECURITY CHECK
In-game purchases are not complicated, but you need to be sure that the Steam user is reliable. To avoid scammers, simply call the /GetReliableUserInfo
endpoint. If the return is true, you can start the microtransaction.
EXAMPLE WITH UNITY (C#)
You can check the example folder to see an example using Unity.
ABOUT
You might be wondering, "Has this code been properly tested?" I used a similar version of this code inside a game called Deliverace. It's no longer available on Steam, but this code works.
If you have any questions, suggestions, or issues, feel free to use the Issues area.
CONTRIBUTION
You can contribute by opening a pull request. Together, we can help many developers implement in-game purchases.