Steam + Эквайринг
Сценарий 1 - по сумме пополнения аккаунта
Используйте данный сценарий, если необходимо пополнить аккаунт на конкретную сумму в рублях
Получение стоимости пополнения
Для заданной суммы пополнения аккаунта рассчитать стоимость пополнения и минимальную цену продажи
Параметры запроса
| Параметр | Обязательный | Тип | Комментарий |
|---|---|---|---|
| netAmount | Да | Число | Сумма пополнения аккаунта в Steam в рублях. Всего после точки может быть 2 цифры для копеек. Пример: 1188.00 |
| account | Да | Строка | Наименование аккаунта в Steam (нельзя использовать Steam ID) |
Параметры ответа
| Параметр | Тип | Комментарий |
|---|---|---|
| price | Число | Стоимость пополнения аккаунта в руб. |
| minPrice | Число | Минимальная цена продажи в руб. (стоимость пополнения плюс минимальная комиссия WATA) |
| steamRate | Число | Расчетный курс долл. → руб. в Steam (может отличаться от фактического). Используется внутри Steam для пересчета пополнений в разных валютах |
Создание заказа
Создать заказ и получить платежную ссылку для заданной суммы пополнения аккаунта.
Доход мерчанта — это цена продажи минус комиссия WATA (% от цены) и стоимость пополнения аккаунта.
Параметры запроса
| Параметр | Обязательный | Тип | Комментарий |
|---|---|---|---|
| account | Да | Строка | Наименование аккаунта в Steam |
| amount | Да | Число | Сумма платежа (транзакции) в рублях, на которую будет создана платежная ссылка. Всего после точки может быть 2 цифры для копеек. Пример: 1188.00. Ограничения на значение: minPrice <= amount <= minPrice*1.5 |
| netAmount | Да | Число | Сумма пополнения аккаунта в Steam в рублях. Всего после точки может быть 2 цифры для копеек. Пример: 1188.00 |
| description | Да | Строка | Описание заказа или другие детали |
| orderId | Да | Строка | Номер заказа. Далее, номер заказа используется для определения статуса |
| successRedirectUrl | Нет | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае успешной оплаты заказа |
| failRedirectUrl | Нет | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае неуспешной оплаты заказа |
Параметры ответа
| Параметр | Тип | Комментарий |
|---|---|---|
| orderId | Строка | Номер заказа. Далее, номер заказа используется для определения статуса |
| amount | Число | Сумма платежа (транзакции) в рублях, на которую будет создана платежная ссылка. Всего после точки может быть 2 цифры для копеек. Пример: 1188.00 |
| price | Число | Стоимость пополнения в руб. |
| minPrice | Число | Минимальная цена продажи в руб. (стоимость пополнения плюс минимальная комиссия WATA) |
| commission | Число | Комиссия WATA в руб. |
| steamRate | Число | Расчетный курс долл. → руб. в Steam (может отличаться от фактического). Используется внутри Steam для пересчета пополнений в разных валютах |
| paymentLink | Строка | Адрес платежной ссылки |
| successRedirectUrl | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае успешной оплаты заказа |
| failRedirectUrl | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае неуспешной оплаты заказа |
Сценарий 2 - по сумме платежа
Используйте данный сценарий, если известна сумма платежа клиента. Сумма пополнения аккаунта будет рассчитана автоматически
Получение суммы пополнения
Для заданной суммы платежа рассчитать стоимость и сумму пополнения аккаунта
Параметры запроса
| Параметр | Обязательный | Тип | Комментарий |
|---|---|---|---|
| amount | Да | Число | Сумма платежа клиента в рублях. Всего после точки может быть 2 цифры для копеек. Пример: 1188.00 |
| margin | Да | Число | Доход мерчанта в рублях (должен быть <= 50% *amount). Учитывается внутри amount |
| account | Да | Строка | Наименование аккаунта в Steam (нельзя использовать Steam ID) |
Параметры ответа
| Параметр | Тип | Комментарий |
|---|---|---|
| netAmount | Число | Сумма пополнения Steam в руб. |
| price | Число | Стоимость пополнения в руб. |
| steamRate | Число | Расчетный курс долл. → руб. в Steam (может отличаться от фактического). Используется внутри Steam для пересчета пополнений в разных валютах |
Создание заказа
Создать заказ и получить платежную ссылку для заданной суммы платежа и дохода мерчанта. Сумма пополнения аккаунта рассчитывается автоматически.
→ POST /api/v3/steam/by-amount
Параметры запроса
| Параметр | Обязательный | Тип | Комментарий |
|---|---|---|---|
| account | Да | Строка | Наименование аккаунта в Steam |
| amount | Да | Число | Сумма платежа (транзакции) в рублях, на которую будет создана платежная ссылка. Всего после точки может быть 2 цифры для копеек. Пример: 1188.00 |
| margin | Да | Число | Доход мерчанта в рублях (должен быть <= 50% *amount). Учитывается внутри amount |
| description | Да | Строка | Описание заказа или другие детали |
| orderId | Да | Строка | Номер заказа. Далее, номер заказа используется для определения статуса |
| successRedirectUrl | Нет | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае успешной оплаты заказа |
| failRedirectUrl | Нет | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае неуспешной оплаты заказа |
Параметры ответа
| Параметр | Тип | Комментарий |
|---|---|---|
| orderId | Строка | Номер заказа |
| amount | Число | Сумма платежа клиента в руб. |
| netAmount | Число | Сумма пополнения Steam в руб. |
| price | Число | Стоимость пополнения в руб. |
| commission | Число | Комиссия WATA в руб. |
| margin | Число | Доход мерчанта в руб. |
| steamRate | Число | Расчетный курс долл. → руб. в Steam (может отличаться от фактического). Используется внутри Steam для пересчета пополнений в разных валютах |
| paymentLink | Строка | Адрес платежной ссылки |
| successRedirectUrl | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае успешной оплаты заказа |
| failRedirectUrl | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае неуспешной оплаты заказа |
Проверка статуса заказа
→ GET /api/v3/steam/order/{id}
Параметры запроса
| Параметр | Обязательный | Тип | Комментарий |
|---|---|---|---|
| id | Да | Строка | Номер заказа |
Параметры ответа
| Параметр | Тип | Комментарий |
|---|---|---|
| orderId | Строка | Номер заказа |
| amount | Число | Сумма платежа (транзакции) в рублях. Всего после точки может быть 2 цифры для копеек. Пример: 1188.00 |
| status | Строка | Статус заказа. Возможные значения: Pending (ожидание оплаты) → Paid (заказ оплачен, в процессе исполнения) → Success (заказ исполнен) / Fail (ошибка) |
| successRedirectUrl | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае успешной оплаты заказа |
| failRedirectUrl | Строка | Адрес страницы магазина, на который произойдет редирект плательщика в случае неуспешной оплаты заказа |