> For the complete documentation index, see [llms.txt](https://galactica-games.gitbook.io/integration-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://galactica-games.gitbook.io/integration-sdk/vvedenie.md). # Введение Общее описание взаимодействий с сервисами LinQ Wallet ### Введение Данная документация описывает процесс интеграции с сервисами LinQ Wallet, а также механизм входа через приложение LinQ Wallet. Вход через приложение кошелька позволяет пользователям проходить авторизацию и открывает доступ ко всем функциям, связанным с движением денежных средств. Это необходимо для повышения удобства использования и безопасности. Тем не менее базовые функции доступны и без авторизации через приложение. ### Обзор возможностей Интеграция через приложение включает в себя следующие модули: * [Регистрация и авторизация](/integration-sdk/sections/registraciya-i-avtorizaciya.md) * [Проверка местоположения](/integration-sdk/sections/proverka-mestopolozheniya.md) * [Денежные операции](/integration-sdk/sections/denezhnye-operacii.md) Для интеграции используется протокол вызова процедур gRPC совместно с Protocol Buffers. Для подключения к сервисам необходимо использовать сгенерированные клиентские библиотеки, которые выдаются согласно договоренностям. Технические детали подключения к сервисам LinQ Wallet описаны на страницах: * [Быстрый старт](/integration-sdk/bystryi-start.md) ### Режимы использования В обоих режимах использования API для пользователя в системе LinQ Wallet заводится свой платежный аккаунт, и к нему же заводится внутренний счет во внутренней валюте, соотносимой с игрой. Операции пополнения и перевода оперируют с балансами на этих внутренних счетах. #### Анонимный (условно) В случае анонимного аккаунта счет заводится так же, как и для обычного, за тем исключением, что переводы на аккаунт кошелька или других игр недоступны. Так же в случае анонимного аккаунта действуют ограничения на максимальное количество хранимых на аккаунтах средств. #### Авторизованный После авторизации пользователя через приложение все операции происходят от имени аккаунта пользователя, зарегистрированного в LinQ Wallet. Это позволяет получить полный доступ ко всем функциям, предоставляемым сервисами LinQ. В частности, пройти KYC, вывести выигранные деньги в кошелек и далее на банковский счет или карту, либо использовать в других играх. ### Проверка местоположения Проверка местоположения нужна, чтобы удовлетворять требованиям местных органов власти, где ведется бизнес, относительно доступных операций и в целом возможности использования сервисов. Так, например, действуют ограничения на финансовые операции на территориях, внесенных в санкционные списки. Так же могут действовать ограничения на определенных территориях для определенных операций или приложений, где требуется дополнительное лицензирование и оно пока не оформлено. Запрет по IP ограничивает использование приложения в целом из региона, запрет по координатам запрещает отдельные операции, но в целом позволяет использовать приложение в демо режиме или для бесплатных игр. ### Финансовые операции После интеграции решения пользователю будут доступны возможности: * пополнить внутренний игровой счет с помощью карты или Apple Pay * перевести средства со счета кошелька на игровой счет * использовать деньги со счета для участия в турнире (или другие внутри игровые покупки) * вывести деньги в кошелек для последующей выплаты на счёт или карту --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://galactica-games.gitbook.io/integration-sdk/vvedenie.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.