PayPal PayVault Provider

Setting up your PayPal account

1. Sign up for PayPal on https://www.paypal.com/
2. Make sure your PayPal account is confirmed. Check out this page for ways to do that.
3. Make sure IPN is enabled for your PayPal account. When asked to enter an IPN postback URL, enter this: http://api.playerio.com/payvault/paypal/postback.

Configuring PayVault on Player.IO

1. Enable PayPal in the PayVault admin panel for your game.
2. Enter the email address you used to sign up for PayPal in the "PayPal Merchant Email" field.
3. If you want to allow coin purchases through PayPal, you need to add one or more coin price points also. Each price point is just a way of telling Player.IO that the user can buy X coins for [minor units] in [currency] with PayPal.
   
   You specify price points as string in the form of [minor units][currency]=[coins], with multiple price points separated with comma.
   
   For example, the string: '100USD=50,75EUR=50' means that users can buy 50 coins for either 1.00 USD or 0.75 EUR with PayPal.

Buying Coins: GetBuyCoinsInfo()

Example of buying coins with PayPal in ActionScript 3:

Required GetBuyCoinsInfo() Arguments
coinamount	The amount of Coins to purchase. The combination of coinamount and currency must be a defined pricepoint in the PayVault setup.
currency	The currency you wish to use for this purchase. The currency must be supported by PayPal, see page 455 of the PayPal Website Standard Integration Guide for supported currencies.
item_name	The description of the purchase as it will be presented to the user
Optional GetBuyCoinsInfo() Arguments
sandbox	If this value is set to "true", the url will go to the PayPal Sandbox for testing.
page_style	These arguments can be used to customize the PayPal checkout page by changing various logos and colors. See page 430 of the PayPal Website Standard Integration Guide for more information.
image_url
cpp_header_image
cpp_headerback_color
cpp_headerborder_color
cpp_payflow_color
lc
return
cancel_return
email	These arguments can be used for pre-filling the PayPal checkout page with information about the user. See page 435 of the PayPal Website Standard Integration Guide for more information.
first_name
last_name
address1
address2
city
country
zip
state
Result Values
paypalurl	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 buying an item directly with PayPal in ActionScript 3:

Required GetBuyDirectInfo() Arguments
currency	The currency you wish to use for this purchase. The currency must be supported by PayPal, see page 455 of the PayPal Website Standard Integration Guide for supported currencies. In addition, all payvaultitems in the purchase must have the corresponding price property defined.
item_name	The description of the purchase as it will be presented to the user
Optional GetBuyDirectInfo() Arguments
sandbox	If this value is set to "true", the url will go to the PayPal Sandbox for testing.
page_style	These arguments can be used to customize the PayPal checkout page by changing various logos and colors. See page 430 of the PayPal Website Standard Integration Guide for more information.
image_url
cpp_header_image
cpp_headerback_color
cpp_headerborder_color
cpp_payflow_color
return
cancel_return
email	These arguments can be used for pre-filling the PayPal checkout page with information about the user. See page 435 of the PayPal Website Standard Integration Guide for more information.
first_name
last_name
address1
address2
city
country
zip
state
Result Values
paypalurl	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.