Kongregate Developers

MMO / Virtual Goods Integration Overview

Integrating your virtual goods game into Kongregate is a straight forward process that can be done in a few days by an experienced engineer. There are some special permissions that have to be set for transaction-enabled games and we screen games to maintain a quality experience, so please email apps@kongregate.com to request permission to publish the game.

Connect to our Client API Object

In order to get access to some required basic user information for the server APIs, you'll need to connect to our local API through either ActionScript or Javascript. You can find out details about the specific language connections in our API Overview page. Throughout the rest of the documentation you will see references to methods for this Kongregate API object.

Integrate a Few Quick APIs

Integration with Kongregate requires implementing 3 of our APIs within your game:

Virtual Goods: You will be able to accept Kongregate’s currency, kreds, as payment within your game. Any non-kreds payment methods will need to be removed. We currently

Authentication: Giving users a single-sign-on experience reduces registration friction, increasing the number of accounts in the game. We have a simple API that allows you to validate a logged-in Kongregate user via a server-side call and get them into your game entirely behind the scenes.

Statistics: This is a very simple API that allows you to submit progress and high scores of players in the game. In addition to on-site leaderboards, this will enable us to put achievements on your game and feature it heavily if it gets a high rating on the site.

Embed the Game on Kongregate

The game itself will be embedded in an iframe on one of our game pages. These iframes should try to stay under 1100 x 700 to account for smaller screens that still make up a fair amount of our audience. We have a pretty hard line at 1150x750 as maximum size. If you have not worked with iframes before, you’ll want to be careful to have a cross-domain cookies workaround in Safari, and to set your P3P headers for IE, or the game won’t work.

Our new iframe resize API can be used if you need to dynamically resize the iframe for varying heights during gameplay. If you are interested in using the resizing API, please contact us at apps@kongregate.com so we can enable it.