Skip to main content

Ronin Store

Overview

Ronin Store (store.roninchain.com) (formerly Mavis Store) is an online marketplace where game developers can sell their in-game items to players, including both on-chain and off-chain items. It offers environments for testing (sandbox) and production to ensure smooth sales integration.

store-example

This documentation is intended for game studios setting up a store on Ronin Store. Throughout the documentation, we refer to you, the seller, as the "merchant."

Features

  • Create on-chain and off-chain items in a user-friendly interface.
  • Create and run private sales for specific customer groups.
  • Create promotion codes for discounts.
  • Accept payments through users' Ronin Waypoint keyless wallets.

Integration

What you need

Prepare the following before integrating with Ronin Store:

  • Graphic assets for the store, including a store logo, item images, and banners. For details, see Register as a merchant.
  • If your sale includes NFTs, prepare the NFT smart contract for deployment to Ronin. Deploy to the Saigon testnet first, complete a security review with Ronin, and then deploy to the mainnet.
  • Prepare your backend server to accept webhooks from the Ronin Store API when a purchase is made, as well as other endpoints. The specific endpoints depend on your integration level. For more information, see Integration levels.

Integration steps

  1. Register as a merchant:
    1. Sign in to the Ronin Developer Console and create an app.
    2. Request access to the Ronin Store service in App Permissions > Ronin Store.
    3. Contact Ronin for access to the sandbox environment.
  2. Prepare graphic assets for the store.
  3. Set up the store in the sandbox environment:
    1. Sign in to the sandbox Ronin Store CMS.
    2. Enter the store information and upload the graphic assets.
    3. Add some items through the sandbox CMS.
    4. Using the preview feature, verify that the items look as expected in the sandbox storefront.
  4. Integrate your backend with the Ronin Store API:
    1. Learn about the integration levels to choose the right level for your project.
    2. Integrate either the basic or advanced API endpoints.
    3. For advanced integration, contact Ronin to enable.
    4. Save the API endpoints in the sandbox Ronin Store CMS.
  5. Test your integration by purchasing items in the sandbox storefront.
  6. If successful, set up the store in the production environment:
    1. Sign in to the production Ronin Store CMS.
    2. Enter the store information and upload the graphic assets.
    3. Add all items through the production CMS.
    4. Submit your items for review and approval by Ronin.
    5. In the production CMS, hide the production environment in the store settings so that your store is only visible in the pre-production environment.
    6. Publish your items to the pre-production storefront and verify that they look as expected.
    7. Enable the production environment in the store settings to make your store visible in the production environment.

CMS and storefront environments

Ronin Store has multiple environments for testing and production, supporting both the CMS for managing items and sales, and the storefront displaying items to players.

EnvironmentTypeDomainNetwork
SandboxCMSronin-store-cms-sandbox.vercel.appSaigon testnet
ProductionCMSstore.roninchain.com/cmsRonin mainnet
SandboxStorefrontronin-store-cms-sandbox.vercel.appSaigon testnet
Pre-productionStorefrontronin-store-preproduction.vercel.appRonin mainnet
ProductionStorefrontstore.roninchain.comRonin mainnet

Integration flow

The integration flow involves moving through different environments, from sandbox to pre-production and production, to test and deploy your items and sales campaigns. The following flowchart outlines the process from creating an app to publishing items on the storefront:

Next steps

Register as a merchant