> For the complete documentation index, see [llms.txt](https://docs.playwallet.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.playwallet.bot/ru/api.md).

# API для платежей в Steam

Официальная документация Play Wallet по API пополнения баланса Steam.

<figure><img src="https://383475811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgX9Vvn1a0PD2qmcerD9%2Fuploads%2FeLXPIvtq63FoV8ZzAXZW%2Fimage.png?alt=media&amp;token=bc38fcfd-7b0b-4e8a-95a0-d3ccd170ddae" alt=""><figcaption></figcaption></figure>

## Вводная информация <a href="#info" id="info"></a>

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

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

<figure><img src="https://383475811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgX9Vvn1a0PD2qmcerD9%2Fuploads%2FrXnLuj7saSCXcPoW9Wp7%2Fimage.png?alt=media&amp;token=fc86c916-a39e-4920-b22d-4791964795e7" alt=""><figcaption></figcaption></figure>

**Наши социальные сети:**\
[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 <a href="#dostupnye-strany-steam" id="dostupnye-strany-steam"></a>

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

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

### Что нужно для интеграции API? <a href="#chto-nuzhno-dlya" id="chto-nuzhno-dlya"></a>

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

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

### Как работает API пополнения аккаунтов Steam? <a href="#kak-rabotaet-api" id="kak-rabotaet-api"></a>

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

<figure><img src="https://383475811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgX9Vvn1a0PD2qmcerD9%2Fuploads%2FjvCDnU6CJIQFnkrspxKE%2Fimage.png?alt=media&amp;token=da3ce85c-d9ab-4d6f-aa76-6ee4267a37dc" alt=""><figcaption></figcaption></figure>

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$.**

### Процент комиссии <a href="#fee" id="fee"></a>

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

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

### Как подключится к API? <a href="#kak-podklyuchitsya-k" id="kak-podklyuchitsya-k"></a>

<figure><img src="https://383475811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgX9Vvn1a0PD2qmcerD9%2Fuploads%2FfbqD2RxcR5iJx5lfDPRV%2Fimage.png?alt=media&amp;token=ca392f29-39f9-4aba-8df9-c12a45575929" alt=""><figcaption></figcaption></figure>

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

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

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

### Юридические документы <a href="#legal" id="legal"></a>

Мы не запрашиваем у вас и не предоставляем вам никаких юридических документов, подтверждающих наше сотрудничество. Всё осуществляется на основе вашего доверия к нашей платформе.

{% hint style="info" %}
Оборот мерчантов Play Wallet за 2023 и 2024 годы – свыше 1 миллиона долларов.
{% endhint %}

### FAQ по подключению API <a href="#faq-po-podklyucheniyu" id="faq-po-podklyucheniyu"></a>

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

### Тестовая, DEV-версия <a href="#testovaya-dev-versiya" id="testovaya-dev-versiya"></a>

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

### Пополнение баланса для создания транзакции <a href="#popolnenie-balansa-dlya" id="popolnenie-balansa-dlya"></a>

<figure><img src="https://383475811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgX9Vvn1a0PD2qmcerD9%2Fuploads%2FQdnXoW6zbYd5EwaMvEEs%2Fimage.png?alt=media&amp;token=a77e9dcb-15f6-4ac7-8d72-955799293290" alt=""><figcaption></figcaption></figure>

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

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

{% hint style="success" %}
Данные UID нашего аккаунта Bybit: **137323163**
{% endhint %}

После того, как вы пополнили баланс, вы можете с помощью команды /balance в [боте](https://t.me/pwMerchantBot) проверить, что все было верно зачислено.

### Инструкция по внутреннему переводу на Bybit по UID <a href="#transfer" id="transfer"></a>

<figure><img src="https://383475811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgX9Vvn1a0PD2qmcerD9%2Fuploads%2FfbW5n2jLChzibrJ3TS7n%2Fbb1.png?alt=media&amp;token=ee1384dc-b870-40e9-844c-bb53f05395fb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://383475811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTgX9Vvn1a0PD2qmcerD9%2Fuploads%2F9SKrnujhaqSylEdVHw4w%2Fbb2.png?alt=media&amp;token=a94954b3-a5c9-45f1-bac6-7beef27b6efb" alt=""><figcaption></figcaption></figure>

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

Если вы допустили ошибку при отправке ордера, например указали неправильную монету, [напишите нам](https://t.me/yspeh_pulse), и мы вернем вам средства.

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

{% hint style="info" %}
Если вы допустили ошибку при отправке ордера, например, указали неправильную монету, напишите нам, и мы вернем вам средства.\
\
Однако, если вы указали неправильный UID, мы не сможем вам помочь. В этом случае обратитесь в службу поддержки ByBit.
{% endhint %}

## Код <a href="#code" id="code"></a>

### Authorization <a href="#authorization" id="authorization"></a>

Все запросы к API должны быть авторизованы с использованием API-ключа, который передается через заголовок [`pw-api-key`](#user-content-fn-1)[^1]. Клиентский IP должен быть в списке разрешенных IP-адресов для данного мерчанта.

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

***

### GET /get-balance <a href="#get-balance" id="get-balance"></a>

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

**Заголовки:**

* `pw-api-key`: API-ключ мерчанта.&#x20;

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

```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/ <a href="#post-create-order" id="post-create-order"></a>

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

**Заголовки:**

* **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/ <a href="#post-pay-order" id="post-pay-order"></a>

Оплата созданного заказа.

**Заголовки:**

* `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} <a href="#get-order-id" id="get-order-id"></a>

Получение статуса заказа.

**Заголовки:**

* `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/ <a href="#get-order-list" id="get-order-list"></a>

Получение истории заказов мерчанта.

**Заголовки:**

* `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"
        }
    ]
}
```

***

### Статусы ордеров <a href="#order-statuses" id="order-statuses"></a>

* **active** - ожидает подтверждения оплаты
* **queued** - Находиться в очереди на выполнение
* **completed** - Успешно выполнен
* **error** - Ошибка выполнения, означает что ордер не оплатился, соотвественно списаний со счета за такой ордер нет

### Ограничения <a href="#ogranicheniya" id="ogranicheniya"></a>

Никаких ограничений на текущий момент.

### Юридические документы <a href="#yuridicheskie-dokumenty" id="yuridicheskie-dokumenty"></a>

Мы не запрашиваем у вас и не предоставляем никаких юридических документов, подтверждающих сотрудничество.

Все взаимодействие основывается исключительно на вашем доверии к нашей платформе.

### Отказ или прекращение сотрудничества <a href="#otkaz-ili-prekrashchenie" id="otkaz-ili-prekrashchenie"></a>

Мы оставляем за собой право отказать в сотрудничестве без объяснения причин.

В случае нарушения условий нашего соглашения сотрудничество с вами будет немедленно прекращено.

### Изменения <a href="#izmeneniya" id="izmeneniya"></a>

Мы оставляем за собой право изменять и обновлять информацию об API по своему усмотрению. Несмотря на то что частые изменения не предполагаются, мы рекомендуем регулярно проверять эту страницу, чтобы быть в курсе актуальной версии.

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

[^1]: