Integración de servidores de Xsolla

With this type of integration, the following tasks are performed on the Xsolla side:

• catalog storage and management
• price management
• storing data on regional prices
• regional restrictions management
• inventory management
• management of promotional campaigns
• user authentication
• user access management
• transaction processing

You don’t need to configure your own server side for these tasks.

Flujo de integración

To integrate with Xsolla servers using the Game Commerce asset:

1. Install the asset.
2. Set up the project in your Publisher Account.
3. Set up Login or implement your own authorization system using the Pay Station access token.
4. Set up the Virtual Currency module (optional).
5. Set up the Virtual Items module.
6. Set up your Unity project.

After the integration is complete, test the payment process.

Contacte con nuestro equipo de integración

Haga clic en el icono de chat de la esquina inferior derecha y contacte con el equipo de integración a través de una aplicación de mensajería. Le responderemos en tiempo real y le ayudaremos a resolver el problema.

Instalar recurso

1. Download Unity.
2. Pick a personal or professional Unity license based on your preferences.
3. Create a new Unity project.
4. Download the asset.
5. Unzip the package.
6. In the Unity editor, go to Assets > Import Package > Custom Package in the main menu and select the asset.
7. Make sure that the Mono compiler is used for creating a game build (for standalone builds only). To do this:

1. 1. Click Edit > Project Settings in the main menu.
   2. Go to the Other Settings > Configuration section.
   3. Make sure that Mono is chosen in the Scripting Backend field.

After installing the asset, launch the Xsollus demo scene from the Assets > Xsolla > DemoCommon > Scene directory. The demo scene shows the features of the asset and represents a possible implementation of the application logic.

For the demo scene, a project in Publisher Account is preset and an in-game store is fully configured.

Default values for the Xsollus demo scene:

You can use the demo scene in two ways:

• as an example
• as an initial version of the login system, inventory, and in-game store in order to get a quick result and expand its capabilities if necessary

To use the demo scene or its parts in your application, add it in build settings:

1. Go to Assets > Xsolla > DemoCommon > Scene and launch the Xsollus scene.
2. Open File > Build settings and click Add Open Scenes.

Establecer el proyecto básico de Login

1. Open your project in Publisher Account.
2. Click Connect in the Login pane or select Login in the side menu.
3. Click Create Login project.

4. Select Standard Login project and click Create and set up. Wait until your new Login project is created. Then you will see the project settings navigation page.
5. In the Login methods block on the navigation page, select the method that suits your game best and click Configure.

1. The Login product offers three options for your games:
   • Classic login
     Users log into the game by providing their username and password. In addition, users can log in using one of their social networks.
   • Passwordless login
     Users log into the game using one-time codes or links sent to their email address or phone number. Login via social networks is also supported.
   • Social login
     Users enter the game only through social networks.

6. In the top settings block on the navigation page, click Callback URLs and set the following parameters:
   • Callback URL — the URL or path in the application to which users are redirected after they have successfully authenticated, confirmed their email, or reset their password. You can specify multiple valid URLs.
   • Error callback URL — the URL or path in the application to which users are redirected in case of an authentication error. If no value is specified, the Callback URL value will be used.

7. Click Save changes.

8. Set up a social login (optional):
   1. Click the name of your Login project in breadcrumb navigation to return to the navigation page.
   2. Go to the Authentication block and select the Social login section.
   3. Connect social networks that users will be able to use to sign up and log into the application:

1. 1. • To connect the desired social network, click the ⚙ icon and select Connect.

1. 1. • To connect several social networks at once, select the required panes (their borders will turn green). Then, from the Manage drop-down menu, select Connect.

1. 1. • To connect all available social networks at once, click Select all. Then, from the Manage drop-down menu, select Connect.

9. Set up OAuth 2.0 authentication:
   1. Click the name of your Login project in breadcrumb navigation to return to the navigation page.
   2. Go to the Security block and select the OAuth 2.0 section.
   3. Click Add OAuth 2.0.
   4. Specify OAuth 2.0 redirect URIs and click Connect.
   5. Copy and save the Client ID.

10. Change the user data storage (optional). By default, user data is stored and processed on the Xsolla’s side. If you want to connect PlayFab, Firebase, or your own custom storage, follow the instructions: Connect user data storage.

During the integration process, you will need the following parameters:

• Login ID. To get it, open Publisher Account, go to the Login > Dashboard section, and click Copy ID beside the name of the Login project.

• Client ID. It can be found in Publisher Account in the Login > your Login project > Security > OAuth 2.0 section.

Set up catalog

Follow the step-by-step instructions to set up virtual currencies and virtual items in your Publisher Account:

• Create virtual currency

• Set up a virtual currency package

• Create virtual items

• Create bundles

Establecer proyecto de Unity

1. Open your Unity project.
2. Click Window > Xsolla > Edit Settings in the main menu.
3. Specify project parameters in the Inspector panel:
   1. In the Login ID field, specify the Login ID from Publisher Account.

1. 2. In the Project ID field, specify the Project ID from Publisher Account.
   3. To enable sandbox mode, check the Enable sandbox? box.
   4. In the Authorization method field, select OAuth2.0.
   5. In the OAuth2.0 client ID field, specify Client ID received when setting up OAuth 2.0 in Publisher Account.

As a result, your project in Publisher Account will be connected to the demo scene.

4. Launch the demo scene Assets > Xsolla > DemoCommon > Scene > Xsollus and make sure that the authorization and other functions are working correctly.
5. Design an interface for the login system, in-game store, and other pages for your application.

6. Set up event handling according to your application logic using SDK methods. Follow the step-by-step tutorials to get started with basic SDK features.

Probar el proceso de pago

After successfully configuring the asset, test the payment process. By default, all payments are made in sandbox mode for any users. Use a test bank card to simulate a successful payment process.

Test the payment process by making real payments:

1. Make sure that you have signed a contract with Xsolla.
2. In your Unity project, uncheck the Enable sandbox? box in the Inspector panel.

Seguir leyendo