PayStation Installation Guide
Version 1.0 (last updated on April 12, 2011)PayStation is a new payment solution which can be integrated on your website to accept payments without redirecting users to Xsolla website. Only 3 clicks are required to choose payment method, calculate payment amount and complete the payment.
PayStation Implementation
In Xsolla Merchant Account (Tools > PayStation) you could find useful information about PayStation and how to implement it.
Direct link URL:
https://secure.xsolla.com/paystation/index.php
List of required parameters
| Field Name | Type | Description | Required? | Example |
|---|---|---|---|---|
| projectid | Integer | Project ID in the Xsolla's system. Available at Personal Account in the Xsolla's system | Yes | 4783 |
You can pass several additional parameters to simplify payment proccess. If they are passed, the user won't have to fill in payment details as they will be autocompleted.
List of additional parameters
| Field Name | Type | Description | Required? | Example |
|---|---|---|---|---|
| id_theme | Integer | Skin type of Xsolla PayStation* | No | 5 |
| v1 | String | User's identification parameter (commonly a user's nick in a game) | No | demo |
| v2 | String | Additional user's identification parameter (depending on the project settings) | No | 0 |
| v3 | String | Additional user's identification parameter (depending on the project settings) | No | 0 |
| out | Float | Game currency amount. Separator «.» (2 digits after the point) | No | 10 |
| String | User's e-mail | No | mail@example.com | |
| local | String | Localization. Russian (ru) and English (en) localizations are available at present. | No | en |
| recomended | Integer | Parameter responsible for the withdrawal of all / recommended methods of payment. 0 - All, 1 - Recommended | No | 1 |
* Allowable vaues:
- 5 - Xsolla Simple
- 6 - Black Simple
- 10 - Xsolla
- 11 - Black
- 12 - Gray
- 13 - Orange
- 14 - Dark
- 15 - Original
- 16 - Blue
- 17 - Fine
- 20 - Xsolla Pay Port
All parameters are passed to PayStation in GET requests.
Important! Parameters should be passed in UTF-8.
Placement options
There are three ways of PayStation positioning. It can be launched in iframe on the website ("In site body"), in the separate window ("Pop-up window") or in lightbox on the website ("LightBox"). Choose the most preferable variant.
After you set up PayStation positioning, a code will be generated in "Plugin Code" field. You can copy and paste the code on your webpage. Please, find code examples below.
In site body
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
</head>
<body>
<iframe id="paystation" src="https://secure.xsolla.com/
paystation/index.php?projectid=4783&
email=mail@example.com&v1=demo&out=10"
width="100%" height="100%">
</iframe>
</body>
</html>
Pop-up window
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
</head>
<body>
<a href="https://secure.xsolla.com/
paystation/index.php?projectid=4783&
email=mail@example.com&v1=demo&out=10
" target="_blank">PayStation
</a>
</body>
</html>
Lightbox
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script type="text/javascript"
src="https://secure.xsolla.com/
paystation/lightbox/jquery-1.4.js">
</script>
<script type="text/javascript"
src="https://secure.xsolla.com/
paystation/lightbox/jquery-ui-1.8.9.custom.js">
</script>
<script type="text/javascript"
src="https://secure.xsolla.com/
paystation/js/lightbox.js">
</script>
<script type="text/javascript">
var paystationparams =
{id_theme: ThemeID, v1: Ident, out: Out, email: EMail}
</script>
</head>
<body>
<a href="#" onclick="LightBox.show(4783)">PayStation
</a>
</body>
</html>
