Introduction
What MM2Empire for Business is, the two products it offers, and how a partner integration fits together.
On this page
What this is#
MM2Empire for Business lets your platform use Murder Mystery 2 items as money. Your users can pay you by selling their items to you, and you can pay your users out by buying items for them, without you holding a single item, running a Roblox account or operating a bot. We own the bot fleet, carry the stock and handle every in-game trade. You make API calls and receive webhooks.
Everything is priced and settled in US dollars, as integer cents. There are no coins on the partner rails and no exchange rate to track: a payout of 1240 is $12.40.
| Product | Direction | What happens |
|---|---|---|
| MM2 Payments | Your user pays you | Your user sells items through a pop-up on your site (or your own screens). We take the item, and you are credited in USD to spend, withdraw, or credit to your user however you like. |
| MM2 Payouts | You pay your user | Your user picks items from our live marketplace (or you place the order server-side). Your float pays for them and our bots deliver the items to their Roblox account. |
How an integration fits together#
Three surfaces make up a partner integration. Each is reached with a different credential, and none of them can stand in for another.
| Surface | Who uses it | Credential |
|---|---|---|
| Partner console at partner.mm2empire.com | The people at your company | A seat login: username, password and an authenticator app. See the console guide. |
Partner API at https://api.mm2empire.com/partner/v1/… | Your server | An API key sent as X-Partner-Key. Never used from a browser. |
| The pop-up (embedded on your site) | Your end users | A one-time session token your server mints for one customer. It is exchanged for a short-lived bearer the moment the pop-up opens. |
The typical shape: your server links a customer, mints a session and hands the token to the pop-up on your page. Your user acts inside the pop-up. We tell your server what happened through a signed webhook, and that webhook is the record you credit or release your user from. Everything is also readable back through the API, so a reconciliation job never has to trust its own memory.
How item delivery actually works#
Roblox does not allow items to be handed to a player who is not present, so every item movement is pull-based. When your user deposits, they join one of our bots in-game and trade the items to it. When we deliver a payout, the item is placed with a bot and your user joins that bot to collect it.
Item copies are fungible: we guarantee the item type, not one specific copy. Large deliveries are split across several trades because Roblox caps how much can move in one, and a single order can hold at most four distinct item types.
Before you start#
- An approved partner account. Applications are reviewed by hand; apply from the partner site and we will be in touch.
- A seat in the console. Your first seat is claimed with a setup code we hand you, then a password and an authenticator app.
- A server that can keep a secret and receive HTTPS requests. Your API key and your webhook signing secret live there and nowhere else.
Ready? The quickstart takes you from a fresh key to a working pop-up.