1.Введение
Крипто-API для пополнения аккаунтов Steam доступно в открытом формате. Это идеальное решение для трейдеров, инвесторов в Steam, игровых магазинов и других заинтересованных сторон.
Наше API активно используется трейдерами и магазинами игр. Оборот мерчантов Play Wallet за 2023 и 2024 годы – свыше 1 миллиона долларов.
2.Что нужно для интеграции API
Чтобы использовать API, необходимо:
- Иметь собственный аккаунт на криптобирже Bybit;
- Предоставить нам IP-адреса ваших серверов для DEV (тестовой) и PROD (боевой) версий;
- Предоставить электронную почту вашего аккаунта Bybit, с которого будут поступать платежи (обязательно).
3.Как работает API пополнения Steam
API реализовано на внутренних переводах Bybit через UID. Для обработки всех платежей, связанных с пополнением баланса Steam, мы официально сотрудничаем с лицензированным процессинговым сервисом.
4.API курсов валют Steam
Вы можете запросить у нас API курсов Steam. Наша команда разработала собственное решение и использует его на платформе Play Wallet.
Все исчисления в USD. Ссылка на API: https://steam-rates.playwallet.bot/docs
5.Процент комиссии
Комиссии устанавливаются индивидуально и зависят от ваших будущих объемов. Стандартная комиссия составляет 4%. Возможное снижение комиссии до 2% при месячном обороте свыше 300 000 долларов.
6.Начало интеграции API
Чтобы быстро подключиться к нашему API, выполните следующие шаги:
- Свяжитесь с нами в Telegram @yspeh_pulse или @volkovecom.
- Мы создадим чат, и вы сможете подключить свою команду к процессу интеграции.
- Предоставьте информацию (IP-адреса для DEV и PROD, электронную почту вашего аккаунта Bybit).
- Наш разработчик предоставит вам необходимые доступы (токен и URL для DEV и PROD) и ответит на ваши вопросы.
Вы можете использовать один и тот же IP-адрес сервера как для PROD-версии, так и для DEV-среды.
Оплату пользователя вы настраиваете на своей стороне, через наше API вы только начисляете деньги пользователям на Steam.
Вы пополняете баланс в нашем API, принимаете оплату от пользователя (любым способом, который выберете), и, если проблем нет, начисляете деньги пользователю. Мы списываем сумму заказа с вашего баланса.
То есть, вам нужно, чтобы на вашем балансе в нашем API были деньги, а способ приема оплаты от ваших пользователей зависит только от вас.
Баланс нашего API вы пополняете через ByBit, как описано на этой странице.
Реализация приема платежей от пользователей осуществляется на вашей стороне.
7.Реализация тестовой DEV-среды
Работая с тестовой версией API, вам не требуется пополнять баланс или оплачивать ордера. Основная задача – убедиться, что все API-запросы обрабатываются корректно и возвращают ответы без ошибок.
8.Внедрение рабочей PROD-версии
После успешной интеграции тестовой версии (DEV) вы сможете приступить к созданию реальных ордеров в Steam.
Если вы планируете изменить IP-адрес сервера для продакшн-версии, пожалуйста, сообщите нам новый IP-адрес заранее.
9.Пополнение баланса для создания реальных транзакции
Когда вы убедитесь, что PROD-версия полностью готова, вы можете начать создавать реальные ордера. Однако перед этим необходимо пополнить баланс.
Отправьте с указанного вами аккаунта Bybit сумму более 1 USDT через внутренний перевод на наш аккаунт. Таким образом, вы будете пополнять баланс каждый раз, когда он будет заканчиваться.
Данные UID нашего аккаунта Bybit: 137323163
10.Инструкция по внутреннему переводу на Bybit по UID
- Войдите в свой аккаунт Bybit (аккаунт должен быть зарегистрирован на электронную почту, которую вы ранее предоставили нам).
- Наведите курсор на свой профиль в Bybit и нажмите «Вывести».
- Выберите монету USDT.
- Укажите, что это Внутренний перевод.
- Напишите аккаунт назначения UID – 137323163
- Укажите сумму вывода и нажмите «Подтвердить»
После отправки средства в течение минуты поступят на ваш баланс API, и вы сможете приступить к созданию ордеров.
Если вы допустили ошибку при отправке ордера, например указали неправильную монету, напишите нам, и мы вернем вам средства.
Однако если вы указали неправильный UID, мы не сможем вам помочь. В этом случае обратитесь в службу поддержки Bybit.
11.Код
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: Логин пользователя, для которого создается заказ.
{
"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 – Ошибка выполнения, означает что ордер не оплатился, соотвественно списаний со счета за такой ордер нет
12.Ограничения
Мы не предоставляем доступ к API в следующих случаях:
- Компаниям, зарегистрированным на территории Российской Федерации, в связи с санкционной политикой.
- Продуктам, которые используют криптовалюту для пополнения баланса Steam (включая копии нашего продукта).
Во всех остальных случаях мы готовы обсудить возможность подключения к нашему API.
13.Юридические документы
Мы не запрашиваем у вас и не предоставляем никаких юридических документов, подтверждающих сотрудничество.
Все взаимодействие основывается исключительно на вашем доверии к нашей платформе.
14.Отказ или прекращение сотрудничества
Мы оставляем за собой право отказать в сотрудничестве без объяснения причин.
В случае нарушения условий нашего соглашения сотрудничество с вами будет немедленно прекращено.
15.Изменения в этом API
Мы оставляем за собой право изменять и обновлять информацию об API по своему усмотрению. Несмотря на то что частые изменения не предполагаются, мы рекомендуем регулярно проверять эту страницу, чтобы быть в курсе актуальной версии.
О всех значительных изменениях мы уведомим в этом разделе.