PayPal PayVault Provider

Setting up your PayPal account

1. Sign up for PayPal on https://www.paypal.com/
2. Make sure you upgrade to a Business Account.
3. Make sure your PayPal account is verified. Check out this page for ways to do that.

Configuring PayVault on PlayerIO

1. Enable PayPal in the PayVault Control 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. Each price point is just a way of telling PayVault that the user can buy X coins for [minor units] in [currency] with PayPal.
   
   You specify price points as a string in the form of [minor units][currency]=[coins], with multiple price points separated by a 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 coin amount and currency must be a defined price point in the PayVault setup.
currency	The currency you wish to use for this purchase. The currency must be supported by PayPal, see Currency Codes in the PayPal developer documentation 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 PayPal checkout page variables in the PayPal developer documentation 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 Auto-fill PayPal checkout page variables in the PayPal developer documentation 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 Currency Codes in the PayPal developer documentation for supported currencies.
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 PayPal checkout page variables in the PayPal developer documentation 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 Auto-fill PayPal checkout page variables in the PayPal developer documentation 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.