Third Party Authentication Guide

Overview

The Playtem platform is a quick and easy way to monetize your audience by rewarding your players with coupons. When a player achieves a predefined moment in his game (eg: end of a mission, level up, high score…), a window appears and one of our partner brands rewards him with a coupon.

Getting started

This document walks through the main integration steps. The following diagram illustrates how the platform works:

Step 1 - Authenticate the player

In order to authenticate players, you need to develop an endpoint page. The Playtem platform is going to send the information’s details to this endpoint whenever players want to purchase an item of your game for the first time. All transaction details are appended to the HTTP GET parameters sent to your endpoint such as this example:

http://your.app.com/playtem_callback.php?gameId=XX&payload=YY

Parameters	Description
gameId	Specifies your game Id on Playtem.
Payload	This parameter contains all transaction details. It is AES encrypted and base64 encoded. For more information about the encryption of this field see the Security section Example Values: ARNCV9oH+GB4KoeDGDmduhBWZfeT94jCnL …

If the user is not authenticated yet, display a login page. After the player has logged in, you can retrieve his id.

Step 2 - Perform the callback

Playtem provides a web service to retrieve the player id:

https://www.playtem.com/Account/LinkAccount?GameId=XX&idOnGame=YY&payload=ZZ

Parameters	Description
GameId	Specifies the game Id, supplied in the request Example Value: 10
idOnGame	The id of your user Example Value: 50abcd
Payload	A secure token, supplied in the request Example Value: epfplafptp7u1rfeg04gfg23toe42