SocialGold PayVault Provider

These instructions are for setting up SocialGold payments that can be displayed to the player trough HTML IFrames or popups.

If you want to use the SocialGold Flash API for in-game payments, scroll down to that section below.

Setting up your SocialGold account

1. Sign up for SocialGold on http://www.jambool.com/
2. Create a new Payment Offer. You can set up the currency name and exchange rate as you like, but you must set the postback URL to:
   http://api.playerio.com/payvault/socialgold/postback

Configuring SocialGold on Player.IO

1. Enable SocialGold in the PayVault admin panel for your game.
2. Enter the secret into the "SocialGold Secret" field. You can find this value when logged on to the SocialGold website by clicking the link called "Secret" in the left-hand menu of the Developer Home page.

Buying Coins: GetBuyCoinsInfo()

Example of bying coins with SocialGold in ActionScript 3:

Required GetBuyCoinsInfo() Arguments
offer_id	The offer id can be found by viewing the Payment Offer you created on the SocialGold website.
Result Values
socialgoldurl	The URL the user should visit to do the purchase. You can show this in a popup or an IFrame or redirect the user to it.

Buying Items: GetBuyDirectInfo()

Example of bying items directly with SocialGold in ActionScript 3:

Required GetBuyCoinsInfo() Arguments
offer_id	The offer id can be found by viewing the Payment Offer you created on the SocialGold website.
title	The description of the purchase as it will be presented to the user
Result Values
socialgoldurl	The URL the user should visit to do the purchase. You can show this in a popup or an IFrame or redirect the user to it.

Using SocialGold Flash API

If you want to use the In-game Flash API from SocialGold, the procedure is slightly different, and you can only use this for purchasing coins. You will need to set up a different offer on their website, and you need to include their Flash API package in your game.

Setting up a SocialGold Flash offer

1. Sign up for SocialGold on http://www.jambool.com/
2. Create a new Virtual Currency Offer. You can set up the currency name and exchange rate as you like, but you must check the Flash Integration checkbox.
3. You alse need to set a postback URL that's specific to your game. You can find this URL on the payvault configuration page in the admin panel.

Configuring SocialGold on Player.IO

1. Enable SocialGold in the PayVault admin panel for your game.
2. Enter the secret into the "SocialGold Secret" field. You can find this value when logged on to the SocialGold website by clicking the link called "Secret" in the left-hand menu of the Developer Home page.

Buying Coins: GetBuyCoinsInfo()

Example of bying coins with SocialGold in ActionScript 3:

Required GetBuyCoinsInfo() Arguments
offer_id	The offer id can be found by viewing the Virtual Currency Offer you created on the SocialGold website.
flash	Set this argument to 'true'
Result Values
offerid	These parameters should be used when creating a service request using the SocialGold Flash API.
userid
signingkey