# API для платежей в Steam
## Вводная информация Наше API для пополнения аккаунтов Steam доступно в открытом формате. Это значит, что абсолютно любой может прийти и настроить его для себя, или своей компании. Это идеальное решение для трейдеров, инвесторов в Steam, игровых магазинов и других заинтересованных сторон. Наше API активно используется, оборот мерчантов Play Wallet за 2023 и 2024 годы – свыше 1 -го миллиона долларов.
**Наши социальные сети:**\ [Telegram-канал](https://t.me/playwallet_news_ru)\ [Telegram чат](https://t.me/playwallet_chat_ru)\ \ **Отзывы о нашей работе:**\ [TrustPilot](https://www.trustpilot.com/review/playwallet.bot)\ [Ton App](https://ton.app/shopping/play-wallet?id=1477)\ \ **Дополнительные вопросы:**\ [Telegram](https://t.me/yspeh_pulse) ### Доступные страны Steam Вы можете пополнять аккаунты Steam следующих стран: * 🇷🇺 Россия * 🇦🇿 Азербайджан * 🇦🇲 Армения * 🇧🇾 Беларусь * 🇰🇿 Казахстан * 🇰🇬 Кыргызстан * 🇲🇩 Молдова * 🇹🇯 Таджикистан * 🇹🇲 Туркменистан * 🇺🇿 Узбекистан * 🇬🇪 Грузия * 🇺🇦 Украина ### Что нужно для интеграции API? Чтобы использовать API, необходимо: * Иметь собственный аккаунт на криптобирже Bybit; * IP-адрес вашего сервера для DEV-версии и PROD-версий; * Telegram ### Как работает API пополнения аккаунтов Steam? **В текущей версии наше API работает только с аккаунтами Bybit**. В первую очередь это необходимо для того, чтобы мы были уверены в чистоте средств, которые поступают на наш крипто-кошелек.
API реализовано на автоматических [внутренних переводах Bybit через UID](https://www.bybit.com/ru-RU/help-center/article/How-to-Withdraw-Assets-via-Internal-Transfer). 1. Вы создаете свой аккаунт на бирже Bybit и пополняете его. 2. Вы отправляете на наш аккаунте Bybit сумму, которую хотите тратить на пополнения аккаунтов Steam 3. Мы моментально зачисляем вам ее на ваш счет. 4. Вы можете приступать к работе, пополняя аккаунты. Когда сумма кончается, вы можете пополнять снова. У нас нет минимальной суммы и максимальной суммы пополнения. **Вы можете протестировать все за 1$.** ### Процент комиссии **Ваша начальная комиссия будет составлять всего 2%.** \ \ Далее, если вы генерируете объем свыше: * \>5000$ в месяц - 1% * \>50,000$ в месяц - 0,5% ### Как подключится к API?
Чтобы быстро подключиться к нашему API, выполните следующие шаги: 1. Откройте наш [телеграм-бот для API ](https://t.me/pwMerchantBot)и нажмите "Начать". Если кнопки нет, используйте команду /start. 2. Используя команды предоставьте боту следующую информацию:\ \- Вашу почту аккаунта Bybit\ \- IP серверов для DEV и PROD-версии 3. Запросите токены доступа с помощью команды в боте Далее вы можете приступать к интеграции. ### Юридические документы Мы не запрашиваем у вас и не предоставляем вам никаких юридических документов, подтверждающих наше сотрудничество. Всё осуществляется на основе вашего доверия к нашей платформе. {% hint style="info" %} Оборот мерчантов Play Wallet за 2023 и 2024 годы – свыше 1 миллиона долларов. {% endhint %} ### FAQ по подключению API * Вы можете использовать один и тот же IP-адрес сервера как для PROD-версии, так и для DEV-среды. * Оплату пользователя вы настраиваете на своей стороне, через наше API вы только начисляете деньги пользователям на Steam. * Вы пополняете баланс в нашем API, принимаете оплату от пользователя (любым способом, который выберете), и, если проблем нет, начисляете деньги пользователю. Мы списываем сумму заказа с вашего баланса. ### Тестовая, DEV-версия **В DEV-версии API, вам не требуется пополнять баланс или оплачивать ордера.** Основная задача – убедиться, что все API-запросы обрабатываются корректно и возвращают ответы без ошибок.\ \ Далее вы можете приступать к интеграции PROD-версии. ### Пополнение баланса для создания транзакции
Когда вы убедитесь, что PROD-версия полностью готова, вы можете начать создавать ордера на пополнение Steam-аккаунтов. Однако перед этим необходимо пополнить баланс. Отправьте с указанного вами аккаунта Bybit сумму более 1 USDT через внутренний перевод на наш аккаунт. Таким образом, вы будете пополнять баланс каждый раз, когда он будет заканчиваться. {% hint style="success" %} Данные UID нашего аккаунта Bybit: **137323163** {% endhint %} После того, как вы пополнили баланс, вы можете с помощью команды /balance в [боте](https://t.me/pwMerchantBot) проверить, что все было верно зачислено. ### Инструкция по внутреннему переводу на Bybit по UID
1. **Войдите в свой аккаунт Bybit** (аккаунт должен быть зарегистрирован на электронную почту, которую вы ранее предоставили нам). 2. Наведите курсор на свой **профиль в Bybit** и нажмите **«Вывести»**. 3. Выберите монету **USDT**. 4. Укажите, что это **Внутренний перевод**. 5. Напишите аккаунт назначения **UID – 137323163** 6. **Укажите сумму вывода** и нажмите **«Подтвердить»**
После отправки средства в течение минуты поступят на ваш баланс API, и вы сможете приступить к созданию ордеров. Если вы допустили ошибку при отправке ордера, например указали неправильную монету, [напишите нам](https://t.me/yspeh_pulse), и мы вернем вам средства. Однако если вы указали неправильный UID, мы не сможем вам помочь. В этом случае обратитесь в службу поддержки Bybit. {% hint style="info" %} Если вы допустили ошибку при отправке ордера, например, указали неправильную монету, напишите нам, и мы вернем вам средства.\ \ Однако, если вы указали неправильный UID, мы не сможем вам помочь. В этом случае обратитесь в службу поддержки ByBit. {% endhint %} ## Код ### Authorization Все запросы к API должны быть авторизованы с использованием API-ключа, который передается через заголовок [`pw-api-key`](#user-content-fn-1)[^1]. Клиентский IP должен быть в списке разрешенных IP-адресов для данного мерчанта. *** ### GET /get-balance Получение баланса мерчанта. А также списка доступных сервисов для оплаты. **Заголовки:** * `pw-api-key`: API-ключ мерчанта. **Пример ответа:** ```json { "status": "success", "message": "", "data": { "balance": "0.00", "frozenBalance": "0.00", "feeRatio": "0.0600", "services": [ { "id": "ff71c998-14be-4e3d-8ad3-0ffc8357265b", "name": "test", "minAmount": "0.25", "maxAmount": "200.00" } ] } } ``` *** ### POST /create-order/ Создание заказа. **Заголовки:** * **pw-api-key**: API-ключ мерчанта **Тело запроса:** * **externalId**: Уникальный идентификатор заказа, предоставленный клиентом. Используется для связи заказа с внешней системой клиента. * **serviceId**: Идентификатор услуги, которую клиент хочет заказать. Должен соответствовать одной из услуг, доступных в системе. * **amount**: Сумма заказа в валюте, установленной для мерчанта. Должна быть представлена в виде строки с двумя десятичными знаками. * **login**: Логин пользователя, для которого создается заказ. DEV логин ***123456789*** ```json { "externalId": "ext-12345", "serviceId": "ff71c998-14be-4e3d-8ad3-0ffc8357265b", "amount": "150.00", "login": "user123" } ``` **Пример ответа:** ```json { "status": "success", "message": "", "data": { "id": "72cf5503-ae6a-45af-97b8-aae3a0731687", "status": "queued", "externalId": "7", "serviceId": "ff71c998-14be-4e3d-8ad3-0ffc8357265b", "amount": "1.00", "amountFee": "0.03", "feeRatio": "0.03", "createdDateTime": "2024-04-18T17:36:55.453116", "expiredDateTime": "2024-04-18T17:46:55.453069", "completedDateTime": null } } ``` *** ### POST /pay-order/ Оплата созданного заказа. **Заголовки:** * `pw_api_key`: API-ключ мерчанта. **Тело запроса:** * Идентификатор заказа (`id`): `"72cf5503-ae6a-45af-97b8-aae3a0731687"` * Время создания заказа (`createdDateTime`): `"2024-04-18T17:36:55.453116"` * Конкатенация: `"72cf5503-ae6a-45af-97b8-aae3a07316872024-04-18T17:36:55.453116"` Применение SHA-512 к конкатенации: `SHA512("72cf5503-ae6a-45af-97b8-aae3a07316872024-04-18T17:36:55.453116")` Результат: Хеш-строка, представляющая токен. - `db8e5992e47c48b46f59ecdd1789cc525f4061a52fbf8200dbdab4bc0929de9cf2f61bd8725314440c498a694176b06a2faec22776be4dc8123fffee14b027a5` {% hint style="info" %} **Примечание:** Мерчант должен самостоятельно сгенерировать токен на своей стороне и передать его в теле запроса при оплате заказа. На dev окружение не связанно с реальными платежами. \*На dev окружение не связанно с реальными платежами. Также на dev окружение при оплате на сумму не равную 1$ ордер закроется как ошибка, при сумме равной 1$ ордер должен закрыться как успешный. {% endhint %} ```json { "id": "72cf5503-ae6a-45af-97b8-aae3a0731687", "externalId": "ext-12345", "token": "db8e5992e47c48b46f59ecdd1789cc525f4061a52fbf8200dbdab4bc0929de9cf2f61bd8725314440c498a694176b06a2faec22776be4dc8123fffee14b027a5" } ``` **Пример ответа:** ```json { "status": "success", "message": "", "data": { "id": "b8509f61-17fd-4578-8529-7bfb29f14d39", "status": "queued", "externalId": "ext-12345", "serviceId": "ff71c998-14be-4e3d-8ad3-0ffc8357265b", "amount": "150.00", "amountFee": "0.00", "feeRatio": "0.00", "createdDateTime": "2024-04-16T03:07:16.739351", "expiredDateTime": "2024-04-16T03:34:14", "completedDateTime": null } } ``` *** ### GET /get-order/{id} Получение статуса заказа. **Заголовки:** * `pw_api_key`: API-ключ мерчанта. **Параметры запроса:** * `id`: Идентификатор заказа. **Пример ответа:** ```json { "status": "success", "message": "", "data": { "id": "72cf5503-ae6a-45af-97b8-aae3a0731687", "status": "completed", "externalId": "7", "serviceId": "ff71c998-14be-4e3d-8ad3-0ffc8357265b", "amount": "1.00", "amountFee": "0.03", "feeRatio": "0.03", "createdDateTime": "2024-04-18T17:36:55.453116", "expiredDateTime": "2024-04-18T17:46:55.453069", "completedDateTime": "2024-04-18T17:44:31.974430" } } ``` *** ### GET /get-order-list/ Получение истории заказов мерчанта. **Заголовки:** * `pw_api_key`: API-ключ мерчанта. **Параметры запроса:** * `offset`: Смещение начала списка (по умолчанию 0). * `limit`: Количество возвращаемых заказов (по умолчанию 10). **Пример ответа:** ```json { "status": "success", "message": "", "data": [ { "id": "8ca9e0bf-b45b-43c4-acb2-93f467b1760e", "status": "active", "externalId": "6", "serviceId": "ff71c998-14be-4e3d-8ad3-0ffc8357265b", "amount": "1.00", "amountFee": "0.03", "feeRatio": "0.03", "createdDateTime": "2024-04-18T17:33:13.510839", "expiredDateTime": "2024-04-18T17:43:13.510798", "completedDateTime": null }, { "id": "72cf5503-ae6a-45af-97b8-aae3a0731687", "status": "completed", "externalId": "7", "serviceId": "ff71c998-14be-4e3d-8ad3-0ffc8357265b", "amount": "1.00", "amountFee": "0.03", "feeRatio": "0.03", "createdDateTime": "2024-04-18T17:36:55.453116", "expiredDateTime": "2024-04-18T17:46:55.453069", "completedDateTime": "2024-04-18T17:44:31.974430" } ] } ``` *** ### Статусы ордеров * **active** - ожидает подтверждения оплаты * **queued** - Находиться в очереди на выполнение * **completed** - Успешно выполнен * **error** - Ошибка выполнения, означает что ордер не оплатился, соотвественно списаний со счета за такой ордер нет ### Ограничения Никаких ограничений на текущий момент. ### Юридические документы Мы не запрашиваем у вас и не предоставляем никаких юридических документов, подтверждающих сотрудничество. Все взаимодействие основывается исключительно на вашем доверии к нашей платформе. ### Отказ или прекращение сотрудничества Мы оставляем за собой право отказать в сотрудничестве без объяснения причин. В случае нарушения условий нашего соглашения сотрудничество с вами будет немедленно прекращено. ### Изменения Мы оставляем за собой право изменять и обновлять информацию об API по своему усмотрению. Несмотря на то что частые изменения не предполагаются, мы рекомендуем регулярно проверять эту страницу, чтобы быть в курсе актуальной версии. О всех значительных изменениях мы уведомим в этом разделе. [^1]: --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.playwallet.bot/ru/api.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.