PlayWallet

API пополнения Steam

Image

Введение

Наше API для пополнения аккаунтов Steam доступно в открытом формате. Это значит, что абсолютно любой может прийти и настроить его для себя, или своей компании. Это идеальное решение для трейдеров, инвесторов в Steam, игровых магазинов и других заинтересованных сторон.

Наше API активно используется, оборот мерчантов Play Wallet за 2023 и 2024 годы – свыше 1 -го миллиона долларов.

Image

Наши социальные сети:
Telegram-канал
Telegram чат

Отзывы о нашей работе:
TrustPilot
Ton App

Дополнительные вопросы:
Telegram

Доступные страны Steam

Вы можете пополнять аккаунты Steam следующих стран:

  • 🇷🇺 Россия
  • 🇦🇿 Азербайджан
  • 🇦🇲 Армения
  • 🇧🇾 Беларусь
  • 🇰🇿 Казахстан
  • 🇰🇬 Кыргызстан
  • 🇲🇩 Молдова
  • 🇹🇯 Таджикистан
  • 🇹🇲 Туркменистан
  • 🇺🇿 Узбекистан
  • 🇬🇪 Грузия
  • 🇺🇦 Украина

Что нужно для интеграции API?

Чтобы использовать API, необходимо:

  • Иметь собственный аккаунт на криптобирже Bybit;
  • IP-адрес вашего сервера для DEV-версии и PROD-версий;
  • Telegram

Как работает API пополнения аккаунтов Steam?

В текущей версии наше API работает только с аккаунтами Bybit. В первую очередь это необходимо для того, чтобы мы были уверены в чистоте средств, которые поступают на наш крипто-кошелек.

Image

API реализовано на автоматических внутренних переводах Bybit через UID.

  1. Вы создаете свой аккаунт на бирже Bybit и пополняете его.
  2. Вы отправляете на наш аккаунте Bybit сумму, которую хотите тратить на пополнения аккаунтов Steam
  3. Мы моментально зачисляем вам ее на ваш счет.
  4. Вы можете приступать к работе, пополняя аккаунты.

Когда сумма кончается, вы можете пополнять снова. У нас нет минимальной суммы и максимальной суммы пополнения. Вы можете протестировать все за 1$.

Процент комиссии

Ваша начальная комиссия будет составлять всего 2%. Далее, если вы генерируете объем свыше:

  • >5000$ в месяц - 1%
  • >50,000$ в месяц - 0,5%

Как подключится к API?

Image

Чтобы быстро подключиться к нашему API, выполните следующие шаги:

  1. Откройте наш телеграм-бот для API и нажмите "Начать". Если кнопки нет, используйте команду /start.
  2. Используя команды предоставьте боту следующую информацию:
    - Вашу почту аккаунта Bybit
    - IP серверов для DEV и PROD-версии
  3. Запросите токены доступа с помощью команды в боте

Далее вы можете приступать к интеграции.

FAQ по подключению API

  • Вы можете использовать один и тот же IP-адрес сервера как для PROD-версии, так и для DEV-среды.
  • Оплату пользователя вы настраиваете на своей стороне, через наше API вы только начисляете деньги пользователям на Steam.
  • Вы пополняете баланс в нашем API, принимаете оплату от пользователя (любым способом, который выберете), и, если проблем нет, начисляете деньги пользователю. Мы списываем сумму заказа с вашего баланса.

Тестовая, DEV-версия

В DEV-версии API, вам не требуется пополнять баланс или оплачивать ордера. Основная задача – убедиться, что все API-запросы обрабатываются корректно и возвращают ответы без ошибок.

Далее вы можете приступать к интеграции PROD-версии.

Пополнение баланса для создания транзакции

Image

Когда вы убедитесь, что PROD-версия полностью готова, вы можете начать создавать ордера на пополнение Steam-аккаунтов. Однако перед этим необходимо пополнить баланс.

Отправьте с указанного вами аккаунта Bybit сумму более 1 USDT через внутренний перевод на наш аккаунт. Таким образом, вы будете пополнять баланс каждый раз, когда он будет заканчиваться.

Данные UID нашего аккаунта Bybit: 137323163

После того, как вы пополнили баланс, вы можете с помощью команды /balance в боте проверить, что все было верно зачислено.

Инструкция по внутреннему переводу на Bybit по UID

  1. Войдите в свой аккаунт Bybit (аккаунт должен быть зарегистрирован на электронную почту, которую вы ранее предоставили нам).
  2. Наведите курсор на свой профиль в Bybit и нажмите «Вывести».
  3. Выберите монету USDT.
  4. Укажите, что это Внутренний перевод.
  5. Напишите аккаунт назначения UID – 137323163
  6. Укажите сумму вывода и нажмите «Подтвердить»
Image

После отправки средства в течение минуты поступят на ваш баланс API, и вы сможете приступить к созданию ордеров.

Если вы допустили ошибку при отправке ордера, например указали неправильную монету, напишите нам, и мы вернем вам средства.

Однако если вы указали неправильный UID, мы не сможем вам помочь. В этом случае обратитесь в службу поддержки Bybit.

Код

Authorization

Все запросы к API должны быть авторизованы с использованием API-ключа, который передается через заголовок pw-api-key. Клиентский IP должен быть в списке разрешенных IP-адресов для данного мерчанта.

https://dev.merchant.playwallet.bot/api/merchant/

GET /get-balance

Получение баланса мерчанта. А также списка доступных сервисов для оплаты.

Заголовки:

  • pw-api-key: API-ключ мерчанта

Пример ответа:

{
    "status": "success",
    "message": "",
    "data": {
        "balance": "0.00",
        "frozenBalance": "0.00",
        "feeRatio": "0.0600",
        "services": [
            {
                "id": "657878cd-fd6c-486c-bd67-8a5960b63afb",
                "name": "test",
                "minAmount": "0.25",
                "maxAmount": "200.00"
            }
        ]
    }
}

POST /create-order/

Создание заказа.

Заголовки:

  • pw-api-key: API-ключ мерчанта

Тело запроса:

  • externalId: Уникальный идентификатор заказа, предоставленный клиентом. Используется для связи заказа с внешней системой клиента.
  • serviceId: Идентификатор услуги, которую клиент хочет заказать. Должен соответствовать одной из услуг, доступных в системе.
  • amount: Сумма заказа в валюте, установленной для мерчанта. Должна быть представлена в виде строки с двумя десятичными знаками.
  • login: Логин пользователя, для которого создается заказ. DEV логин 123456789
{
  "externalId": "ext-12345",
  "serviceId": "657878cd-fd6c-486c-bd67-8a5960b63afb",
  "amount": "150.00",
  "login": "user123"
}

Пример ответа:

{
    "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

Примечание: Мерчант должен самостоятельно сгенерировать токен на своей стороне и передать его в теле запроса при оплате заказа. На dev окружение не связанно с реальными платежами.
{
  "id": "72cf5503-ae6a-45af-97b8-aae3a0731687",
  "externalId": "ext-12345",
  "token": "db8e5992e47c48b46f59ecdd1789cc525f4061a52fbf8200dbdab4bc0929de9cf2f61bd8725314440c498a694176b06a2faec22776be4dc8123fffee14b027a5"
}

Пример ответа:

{
    "status": "success",
    "message": "",
    "data": {
        "id": "b8509f61-17fd-4578-8529-7bfb29f14d39",
        "status": "queued",
        "externalId": "ext-12345",
        "serviceId": "cc3848b1-f50b-4f4d-82d3-af32fe4ba35c",
        "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: Идентификатор заказа

Пример ответа:

{
    "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)

Пример ответа:

{
    "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 по своему усмотрению. Несмотря на то что частые изменения не предполагаются, мы рекомендуем регулярно проверять эту страницу, чтобы быть в курсе актуальной версии.

О всех значительных изменениях мы уведомим в этом разделе.