whitemarket Документація для партнерів

Купівля скіна

Якщо ви купуєте за допомогою власного облікового запису Steam, вам потрібно встановити розширення Chrome або мобільний додаток WhiteMarket.

Купити конкретний скін

  1. Використайте експортний файл або GraphQL API для пошуку ID продукту.

  2. Викличте mutation market_buy з ID продукту. image

    Наполегливо рекомендуємо передавати власний customId (ідентифікатор угоди у вашій системі) у market_buy. Якщо сервер повернув помилку 5xx, не повторюйте купівлю — угода вже могла бути створена. Натомість зачекайте 10–20 секунд і перевірте результат через deal_item або deal_history_item, використовуючи ваш customId.

  3. Використайте deal_buyer_statuses, щоб отримати коротку інформацію про угоду.

  4. Зачекайте на статус OFFERED. image

  5. Підтвердіть пропозицію в Steam. Якщо ви використали опцію link у market_buy - попросіть одержувача підтвердити пропозицію в Steam.

  6. Зачекайте на статус EXCHANGED або COMPLETED. image

Статус EXCHANGED та поле isTradeProtected = true означає захист торгівлі Steam на 7 днів. Вам потрібно зачекати, поки settlementTimeAt не досягне статусу COMPLETED

Купити скін за хешем назви з найнижчою ціною

  1. Використайте export file.

  2. АБО викличте mutation market_buy з хешем назви та, за бажанням, максимальною ціною. image image

    Наполегливо рекомендуємо передавати власний customId (ідентифікатор угоди у вашій системі) у market_buy. Якщо сервер повернув помилку 5xx, не повторюйте купівлю — угода вже могла бути створена. Натомість зачекайте 10–20 секунд і перевірте результат через deal_item або deal_history_item, використовуючи ваш customId.

  3. Використайте deal_buyer_statuses, щоб отримати коротку інформацію про угоду.

  4. Зачекайте на статус OFFERED. image

  5. Підтвердіть пропозицію в Steam. Якщо ви використали опцію link у market_buy - попросіть одержувача підтвердити пропозицію в Steam.

  6. Зачекайте на статус EXCHANGED або COMPLETED. image

Статус EXCHANGED та поле isTradeProtected = true означає захист торгівлі Steam на 7 днів. Вам потрібно зачекати, поки settlementTimeAt не досягне статусу COMPLETED

Повна інформація про угоду

  • deal_item щоб отримати повну інформацію про угоду.
  • deal_history_item щоб отримати повну інформацію про угоду після її завершення.