# Обновление ключа Source: https://steamgold.dev/api-docs/auth/refresh POST /auth/refresh-tokens Обновляет токен # Доступные валюты Source: https://steamgold.dev/api-docs/currency/available GET /currency/available Возвращает список доступных валют в Steam # Курс валютной пары Source: https://steamgold.dev/api-docs/currency/pair GET /currency/{pair} Возвращает историю котировок конкретной валютной пары # Список курсовых пар Source: https://steamgold.dev/api-docs/currency/pairs GET /currency Возвращает список последних котировок валютных пар # Выставление счета Source: https://steamgold.dev/api-docs/gear/checkout POST /gear/{id}/checkout Выставляет счет на покупку снаряжения # Создание намерения Source: https://steamgold.dev/api-docs/gear/create POST /gear Создает намерение для покупки снаряжения # Поиск снаряжения Source: https://steamgold.dev/api-docs/gear/search POST /gear/search Позволяет искать и фильтровать доступное снаряжение по различным критериям. # Проверка намерения Source: https://steamgold.dev/api-docs/gear/status GET /gear/{id} Получает информацию о намерении купить снаряжение # Каталог подарков Source: https://steamgold.dev/api-docs/gifts/catalog GET /gifts/catalog Возвращает список доступных игр в каталоге подарков с пагинацией # Выставление счета Source: https://steamgold.dev/api-docs/gifts/checkout POST /gifts/{id}/checkout Выставляет счет на оплату подарка # Создание намерения Source: https://steamgold.dev/api-docs/gifts/create POST /gifts Создает намерение для покупки Steam-игры в подарок # Информация об игре Source: https://steamgold.dev/api-docs/gifts/game GET /gifts/catalog/{appId} Возвращает информацию о конкретной игре, включая доступные издания и цены # Проверка намерения Source: https://steamgold.dev/api-docs/gifts/status GET /gifts/{id} Получает информацию о намерении покупки подарка # Проверка подарка Source: https://steamgold.dev/api-docs/gifts/verify POST /gifts/verify Проверяет доступность и возможность покупки подарка # Выставление счета Source: https://steamgold.dev/api-docs/gold/checkout POST /gold/{id}/checkout Выставляет счет на пополнение баланса # Создание намерения Source: https://steamgold.dev/api-docs/gold/create POST /gold Создает намерение пополнения баланса # Проверка намерения Source: https://steamgold.dev/api-docs/gold/status GET /gold/{id} Получает информацию о намерении пополнения баланса # Проверка аккаунта Source: https://steamgold.dev/api-docs/gold/verify POST /gold/verify Проверяет возможность пополнения баланса # Выставление счета Source: https://steamgold.dev/api-docs/items/checkout POST /items/{id}/checkout Выставляет счет на оплату покупки # Создание намерения Source: https://steamgold.dev/api-docs/items/create POST /items Создает намерение для покупки # Проверка намерения Source: https://steamgold.dev/api-docs/items/status GET /items/{id} Получает информацию о намерении пополнения баланса # Проверка товара Source: https://steamgold.dev/api-docs/items/verify POST /items/verify Проверяет доступность и возможность покупки товара # Добавление намерении Source: https://steamgold.dev/api-docs/pouch/add-intent POST /pouch/{pouchId}/intents Добавляет существующее намерение в корзину # Выставление счета Source: https://steamgold.dev/api-docs/pouch/checkout POST /pouch/{pouchId}/checkout Выставляет счет на оплату корзины (один счет на все намерения корзины) # Создание корзины Source: https://steamgold.dev/api-docs/pouch/create POST /pouch Создает новую пустую корзину для последующего наполнения намерениями # Получение корзины Source: https://steamgold.dev/api-docs/pouch/get GET /pouch/{pouchId} Возвращает детальную информацию о корзине и содержащихся в ней намерениях # Удаление намерения Source: https://steamgold.dev/api-docs/pouch/remove-intent DELETE /pouch/{pouchId}/intents/{intentId} Удаляет намерение из корзины # Проверка корзины Source: https://steamgold.dev/api-docs/pouch/verify GET /pouch/{pouchId}/verify Проверяет возможность оплаты корзины # Проверка промкода Source: https://steamgold.dev/api-docs/promo/verify POST /promo/verify Проверяет существование промокода # Доступность товаров Source: https://steamgold.dev/api-docs/treasures/items GET /treasures/items/{platform} Отображает список доступных товаров для платформы # Атрибуция Source: https://steamgold.dev/attribution Продвинутая работа с источниками трафика Для дополнительной аналитики источников трафика вы можете использовать атрибуцию внутри нашего API. Атрибуция позволяет отслеживать, откуда пришел пользователь, и связывать его действия с определенным источником и рекламной кампанией. ## Как это работает При создании намерения вы можете указать источник, передав его в поле `attribution`. Это может быть идентификатор рекламной кампании, название источника или любое другое значение, которое поможет вам идентифицировать источник трафика. ```json theme={null} { "account": "goldEnjoyer", "email": "gold@example.com", "platform": "steam", "amount": 10000, "currency": "RUB", "attribution": { "utm_source": "google", "utm_medium": "cpc", "utm_campaign": "black_friday" } } ``` Два обязательных поля для атрибуции — это `utm_source` и `utm_medium`. Кроме этих двух полей вы также можете передавать и дополнительные параметры в поле `attribution`, которые помогут вам лучше понять, откуда пришел пользователь. ## Работа с CPA сетями Если вы используете CPA сети, вы можете передавать требуемые параметры CPA сетей в поле `attribution`. Со своей стороны, мы будем передавать эти данные в CPA сети, через postback запросы. Для включения этой функции вам нужно будет связаться с нашей службой поддержки. # Получение доступа Source: https://steamgold.dev/auth Как получить доступ к API Стимголд Для получения ключа доступа к API Стимголд, вам необходимо связаться с нашими менеджерами по электронной почте. После этого вам будет предоставлен набор из ключей, который вы сможете использовать для доступа к нашему API. ### Виды ключей У нас есть два вида ключей: * **Access token** — ключ доступа, который позволяет получить доступ к основным методам API Стимголд * **Refresh token** — ключ обновления, который позволяет обновить ключ доступа в случае его утечки или истечения срока действия ### Использование ключа доступа Для использования ключа доступа, вам необходимо передавать его в заголовке `Authorization Bearer` при каждом запросе к API. Пример использования ключа доступа: ```json theme={null} // Заголовок запроса { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } ``` ### Использование ключа обновления Для обновления ключа доступа, вам необходимо отправить запрос на обновление ключа доступа, передав в теле запроса ключ обновления. Пример использования ключа обновления: ```json theme={null} // Тело запроса { "refreshToken": "YOUR_REFRESH_TOKEN" } ``` Ответ будет содержать новый ключ доступа, который вы сможете использовать для доступа к API. Подробнее о методе обновления ключа доступа вы можете прочитать в разделе [Обновление ключа](/api-docs/auth/refresh). # История изменений Source: https://steamgold.dev/changelog Последние обновления и новые возможности #### Новый API для покупки Steam-игр в подарок Добавлен новый API для покупки Steam-игр в подарок другому пользователю. Теперь вы можете просматривать каталог доступных игр, получать список изданий с ценами по регионам, проверять доступность и создавать намерения для покупки подарка. Доставка происходит автоматически через ссылку для добавления в друзья в Steam. #### Новый API для работы с корзинами Добавлены методы API для создания и управления корзинами. Теперь вы можете создавать корзины, добав лять намерения в корзину, выставлять счета на оплату и проверять статус корзины. #### Добавлен срок жизни намерения Теперь намерения будут автоматически истекать через некоторое время с момента создания, если не были оплачены. По умолчанию срок жизни намерения составляет 1 час. #### Добавлена информация о курсах валют Steam Теперь вы можете получать актуальные курсы валют Steam с помощью новых методов API для дополнительной конвертации на вашей стороне. #### Добавлена информация о статусе доставки Теперь при просмотре намерения вы можете получить информацию о доставке, её статус и идентификатор. Актуально для товаров и снаряжения, которые работают с асинхронной доставкой — письма, торговые предложения в Steam. #### Новый API для работы со снаряжением Добавлен новый API для работы со снаряжением. Теперь вы можете создавать намерения для покупки снаряжения, проверять его доступность и получать информацию о каждом предмете снаряжения. #### Атрибуция трафика Теперь при создании намерения можно передавать атрибуцию трафика в поле `attribution`. Это позволит вам отслеживать источники трафика и связывать их с действиями пользователей. #### Дополнительные поля при создании намерения Некоторые товары требуют не только аккаунт пользователя, но и дополнительные параметры. Теперь при загрузке списка товаров вы можете получить список дополнительных полей, которые необходимо передать при создании намерения. #### Загрузка списка товаров Для отображения наличия товаров в реальном времени, мы добавили дополнительный метод API для загрузки списка товаров с подробной информацией о каждом товаре и его наличии. #### Поддержка промокодов Теперь при создании намерения можно использовать поле `code` для передачи промокода. Промокоды могут быть использованы для предоставления скидок или других бонусов. #### API для покупки товаров Добавлены методы API для покупки товаров. Теперь вы можете проверять доступность товара, создавать намерения для покупки товаров и выставлять счета на оплату. #### Добавлена возможность управления комиссией Теперь при создании намерения можно использовать поле `fee` с двумя значениями: * `included` — переданная сумма включает комиссию. В этом случае поля `amount` и `currency` представляют собой общую сумму к оплате, а сумма пополнения рассчитывается автоматически путем вычитания комиссии. * `excluded` — переданная сумма не включает комиссию. В этом случае поля `amount` и `currency` представляют собой сумму пополнения, а итоговая сумма к оплате рассчитывается автоматически путем добавления комиссии. * `naive` — переданная сумма включает комиссию. В этом случае поля `amount` и `currency` представляют собой сумму к оплате. А сумма пополнения рассчитывается от суммы к оплате, а не от суммы пополнения. #### Более прозрачная информация о платеже Теперь все методы API возвращают два поля: `intentAmount` и `paymentAmount`. `intentAmount` — это сумма пополнения, а `paymentAmount` — это сумма платежа. #### Добавлен раздел Тестирование * Настройка тестового доступа * Тестирование верификации * Тестирование оплаты #### Добавлена информация по получению доступа к API * Обновление ключа доступа #### Добавлены основные методы API * Создание намерения * Проверка статуса намерения * Выставление счета # Курсы валют Steam Source: https://steamgold.dev/currency Получения информации о доступных валютах и курсах валютных пар в Steam. Наш API работает в RUB и автоматически конвертирует сумму в нужную валюту при создании намерения на покупку. Вы можете использовать этот API для дополнительной конвертации переводов в RUB на вашей стороне. ## Доступные валюты Steam поддерживает множество валют для различных регионов. Вы можете получить список всех доступных валют в [их документации](https://partner.steamgames.com/doc/store/pricing/currencies) или с помощью [нашего метода API](/api-docs/currency/available). Пример ответа: ```json theme={null} { "status": 200, "items": [ { "currency_code": "AED", "descriptiopn": "United Arab Emirates Dirham" }, { "currency_code": "AUD", "descriptiopn": "Australian Dollars" }, ... { "currency_code": "ZAR", "descriptiopn": "South African Rand" } ], "total": 37 } ``` ## Курсовые пары Для конверсии валют вы можете использовать метод [списка курсовых пар](/api-docs/currency/pairs), который возвращает все доступные валютные пары и их текущие курсы. Пример ответа: ```json theme={null} { "status": 200, "items": [ { "currency_pair": "USD:CNY", "close_price": 7.1, "created_at": "2025-10-26T21:10:19.000000Z" }, { "currency_pair": "USD:JPY", "close_price": 152.9, "created_at": "2025-10-26T21:10:22.000000Z" }, ... { "currency_pair": "UAH:BRL", "close_price": 0.13, "created_at": "2025-10-26T21:11:23.000000Z" } ], "total": 55 } ``` Мы поддерживаем 55 валютных пар для конверсии между различными валютами Steam. ## Курс конкретной валютной пары Если вам нужно получить курс конкретной валютной пары, вы можете использовать метод [курс валютной пары](/api-docs/currency/pair). Просто укажите нужную валютную пару в формате `FROM:TO`, например, `USD:EUR`. Пример ответа: ```json theme={null} { "status": 200, "items": [ { "currency_pair": "USD:RUB", "close_price": 80.58, "created_at": "2025-10-26T21:10:03.000000Z" } ], "total": 1 } ``` Кроме этого вы можете передать параметр `count`, чтобы получить историю изменения курса за определённое количество дней. Максимальное значение — 90 дней. # API снаряжения Source: https://steamgold.dev/gear Как узнать какое снаряжение доступно для покупки до создания намерения Подобно другим товарам, снаряжение может быть временно недоступно из-за технических работ на Steam или других причин. Мы рекомендуем регулярно обновлять список доступного снаряжения, чтобы всегда показывать актуальный статус и цены на вашей платформе. Это обеспечивает наилучший опыт для ваших пользователей и избавляет вас от необходимости ручного обновления. Для того чтобы получить список доступного снаряжения на платформе, можно использовать [метод загрузки списка снаряжения](/api-docs/gear/search). В ответе на запрос будет содержаться список предметов снаряжения, которые доступны для покупки с подробным описанием каждого. *** ## Описание структуры запроса Для поиска и фильтрации снаряжения вы можете отправить `POST` запрос с телом, содержащим следующие параметры. Все поля в запросе являются необязательными, и вы можете комбинировать их для получения нужного списка предметов. ```json theme={null} { "query": "Asiimov", "filters": { "price": {"min": 0, "max": 2029147 }, "weapon": [ "AK-47" ], "type": [ "Rifle" ], "rarity": [ "Covert" ], "exterior": [ "Minimal Wear" ], "quality": [ "Normal" ] }, "limit": 10, "page": 1, "sort": "price_asc" } ``` ### Поля запроса Список всех возможных полей, которые вы можете использовать в запросе для поиска снаряжения. | Поле | Тип | Описание | Примеры | | :----------------- | :-------------- | :----------------------------------------------------------------------------------------------------------------------- | :------------------------------------- | | `platform` | `number` | Идентификатор приложения Steam, для которого вы хотите получить снаряжение. По умолчанию `730`. | `730` (для CS2) | | `query` | `string` | Строка поиска по названию предмета. Используется для фильтрации снаряжения по названию или части названия. | `AK-47`, `Asiimov` | | `filters` | `object` | Объект, содержащий параметры фильтрации для поиска снаряжения. Все поля внутри `filters` необязательны. | `{"price": {"min": 100, "max": 5000}}` | | `filters.price` | `object` | Фильтрация по диапазону цен. Значения `min` и `max` указываются в **центах**. | `{"min": 1000, "max": 50000}` | | `filters.type` | `Array` | Фильтрация по типу снаряжения. Возможные значения соответствуют полю `details.type` в ответе | `["Knife", "Glove"]` | | `filters.rarity` | `Array` | Фильтрация по редкости предмета. Возможные значения соответствуют полю `details.rarity` в ответе. | `["Covert", "Restricted"]` | | `filters.exterior` | `Array` | Фильтрация по внешнему износу для скинов оружия. Возможные значения соответствуют полю `details.exterior` в ответе. | `["Factory New", "Minimal Wear"]` | | `filters.quality` | `Array` | Фильтрация по качеству предмета (например, StatTrak™). Возможные значения соответствуют полю `details.quality` в ответе. | `["StatTrak™", "Souvenir"]` | | `filters.phase` | `Array` | Фильтрация по фазе Доплера для ножей (например, `phase1`, `emerald`). | `["emerald", "ruby"]` | | `limit` | `number` | Максимальное количество предметов в ответе. Используется для пагинации. | `10`, `50` | | `page` | `number` | Номер страницы результатов. Используется для пагинации. | `1`, `2`, `5` | | `sort` | `string` | Параметр сортировки результатов. Возможные значения: `price_asc`, `price_desc`. По умолчанию `price_asc`. | `price_asc` | ### Возможные значения для фильтров Здесь представлены возможные значения для каждого фильтра, которые вы можете использовать в запросе. Эти значения соответствуют полям в ответе API и позволяют вам гибко настраивать поиск снаряжения. | Фильтр | Возможные значения | | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `price` | Числовой диапазон, например: `{"min": 100, "max": 5000}` (в копейках) | | `type` | `Agent`, `Charm`, `Collectible`, `Container`, `Equipment`, `Gift`, `Gloves`, `Graffiti`, `Key`, `Knife`, `Machinegun`, `Music Kit`, `Pass`, `Patch`, `Pistol`, `Rifle`, `Shotgun`, `SMG`, `Sniper Rifle`, `Sticker`, `Tag`, `Tool` | | `weapon` | `AK-47`, `AUG`, `AWP`, `Bayonet`, `Bowie Knife`, `Butterfly Knife`, `Classic Knife`, `CZ75-Auto`, `Desert Eagle`, `Dual Berettas`, `Falchion Knife`, `FAMAS`, `Five-SeveN`, `Flip Knife`, `G3SG1`, `Galil AR`, `Glock-18`, `Gut Knife`, `Huntsman Knife`, `Karambit`, `Kukri Knife`, `M249`, `M4A1-S`, `M4A4`, `M9 Bayonet`, `MAC-10`, `MAG-7`, `MP5-SD`, `MP7`, `MP9`, `Navaja Knife`, `Negev`, `Nomad Knife`, `Nova`, `P2000`, `P250`, `P90`, `Paracord Knife`, `PP-Bizon`, `R8 Revolver`, `Sawed-Off`, `SCAR-20`, `SG 553`, `Shadow Daggers`, `Skeleton Knife`, `SSG 08`, `Stiletto Knife`, `Survival Knife`, `Talon Knife`, `Tec-9`, `UMP-45`, `Ursus Knife`, `USP-S`, `XM1014`, `Zeus x27` | | `item_set` | `The Italy Collection`, `The Train Collection`, `The Safehouse Collection`, `The Gods and Monsters Collection`, `The Dreams & Nightmares Collection`, `The Wildfire Collection`, `The Spectrum Collection`, `The Spectrum 2 Collection`, `The Fracture Collection`, `The Horizon Collection`, `The Glove Collection`, `The Snakebite Collection`, `Broken Fang Agents`, `The Breakout Collection`, `The Gamma 2 Collection`, `The Shadow Collection`, `The eSports 2014 Summer Collection`, `The Chroma 2 Collection`, `The Clutch Collection`, `The Revolver Case Collection`, `The Prisma Collection`, `The Gamma Collection`, `The Chroma Collection`, `The Chroma 3 Collection`, `The Operation Riptide Collection`, `Operation Riptide Agents`, `The Prisma 2 Collection`, `The Danger Zone Collection`, `The Dust 2 Collection`, `The Bank Collection`, `The Falchion Collection`, `The Alpha Collection`, `The Phoenix Collection`, `The Winter Offensive Collection`, `The Vanguard Collection`, `The Arms Deal 3 Collection`, `The 2018 Inferno Collection`, `The 2018 Nuke Collection`, `The Operation Broken Fang Collection`, `The Cache Collection`, `The 2021 Train Collection`, `The Huntsman Collection`, `The Rising Sun Collection`, `The Control Collection`, `Shattered Web Agents`, `The Operation Hydra Collection`, `The Lake Collection`, `The Recoil Collection`, `The Revolution Collection`, `The Canals Collection`, `The 2021 Dust 2 Collection`, `The Shattered Web Collection`, `The CS20 Collection`, `The Overpass Collection`, `The eSports 2013 Winter Collection`, `The Aztec Collection`, `The 2021 Mirage Collection`, `The Blacksite Collection`, `The 2021 Vertigo Collection`, `The Ancient Collection`, `The St. Marc Collection`, `The eSports 2013 Collection`, `The X-Ray Collection`, `The Inferno Collection`, `The Nuke Collection`, `The Chop Shop Collection`, `The Arms Deal 2 Collection`, `The Cobblestone Collection`, `The Mirage Collection`, `The Arms Deal Collection`, `The Havoc Collection`, `The Norse Collection`, `The Anubis Collection`, `The Vertigo Collection`, `The Bravo Collection`, `The Dust Collection`, `The Baggage Collection`, `The Assault Collection`, `The Office Collection`, `The Militia Collection`, `The Kilowatt Collection`, `The Gallery Collection`, `The Overpass 2024 Collection`, `The Sport & Field Collection`, `Limited Edition Item`, `The Graphic Design Collection`, `The Ascent Collection`, `The Boreal Collection`, `The Radiant Collection`, `The Fever Collection`, `The Train 2025 Collectio` | | `rarity` | `Base Grade`, `Classified`, `Consumer Grade`, `Contraband`, `Covert`, `Distinguished`, `Exceptional`, `Exotic`, `Extraordinary`, `High Grade`, `Industrial Grade`, `Master`, `Mil-Spec Grade`, `Remarkable`, `Restricted`, `Stock`, `Superior` | | `exterior` | `Battle-Scarred`, `Factory New`, `Field-Tested`, `Minimal Wear`, `Not Painted`, `Well-Worn` | | `quality` | `★`, `Normal`, `Souvenir`, `StatTrak™` | | `phase` | `phase1`, `phase2`, `phase3`, `phase4`, `emerald`, `ruby`, `blackpearl` | | `float` | Числовое значение износа (от 0.0 до 1.0). Например: `{"min": 0.0, "max": 0.5}` | ## Описание структуры ответа Ниже представлен полный список возможных полей для каждого объекта снаряжения. Некоторые поля могут отсутствовать (быть `null`), если они не применимы к конкретному типу предмета. ```json theme={null} { "status": "200", "items": [ { "id": 27104403, "name": "AK-47 | Asiimov (Battle-Scarred)", "price": 12345, "image": "https://steamcommunity-a.akamaihd.net/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpot7HxfDhjxszJemkV092lnYmGmOHLO77QgHIfv5Fwj-2W8I2hiVLg_0Y-amjxcdKUJwVsZgvWqVG7yby-0JS8u8vKz2wj5HdYywfQ1A", "inspectLink": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20S76561199211314126A42560803676D148280691212945393", "description": "Powerful and reliable, the AK-47 is one of the most popular assault rifles in the world. It is most deadly in short, controlled bursts of fire. It has been custom painted with a sci-fi design.", "details": { "type": "Rifle", "weapon": "AK-47", "set": "The Danger Zone Collection", "quality": "Normal", "rarity": "Covert", "exterior": "Battle-Scarred", "phase": null, "tournament": "PGL Copenhagen 2024", "color": null }, "paint": { "float": 0.46424803137779236, "seed": 996, "index": 801, "pattern": 7 }, "attachments": [ { "id": 7258, "name": "Наклейка | Virtus.pro | Копенгаген-2024", "image": "https://steamcommunity-a.akamaihd.net/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulROWEPTTOz_h52CHEtkGgxYurXrKgU4hqqZKW1E7t_jw9Xaw6Oma-jVwTsIv5Ahj7-Q84n03lDi_BI9ZnezetFI5OjJmg", "wear": null, "type": "sticker" }, null, null, null, null ] }, ... ], "total": 42 } ``` ### Поля верхнего уровня ответа | Поле | Тип | Описание | Примеры | | :------------ | :--------------- | :----------------------------------------------------------------------------- | :----------------------------------------------------------------------------- | | `status` | `string` | Статус ответа API. | `200` (успех), `400` (неверный запрос) | | `items` | `Array` | Массив объектов снаряжения, соответствующих критериям запроса. | `[ { ... } ]` | | `total` | `number` | Общее количество предметов, найденных по запросу (без учёта `limit` и `page`). | `42`, `1005` | | `id` | `number` | Уникальный идентификатор предмета. | `27104403`, `16910595` | | `name` | `string` | Отображаемое название предмета (например, название скина). | `AK-47 \| Asiimov`, `Наклейка \| FaZe Clan \| Stockholm 2021`, `Именной ярлык` | | `price` | `number` | Цена предмета в **копейках**. | `12345` (для 123.45₽) | | `image` | `string` | URL-адрес иконки/миниатюры предмета. | `https://steamcommunity-a.akamaihd.net/economy/image/...` | | `inspectLink` | `string`, `null` | Ссылка для осмотра предмета в игре, если доступна (для скинов). | `steam://rungame/730/...`, `null` | | `description` | `string`, `null` | Основной описательный текст предмета. | `Мощный и надёжный AK-47 — один из самых популярных автоматов в мире.` | ### Объект `details` Этот объект содержит детализированные метаданные о предмете снаряжения. | Поле | Тип | Описание | | :----------- | :--------------- | :------------------------------------------------------------------------------------------------------ | | `type` | `string` | Общая классификация предмета. Соответствует ключам фильтра `filters.type`. | | `weapon` | `string`, `null` | Конкретное название оружия, если предмет является скином оружия. Соответствует ключам `filters.weapon`. | | `set` | `string`, `null` | Название коллекции или кейса, к которому принадлежит предмет. Соответствует ключам `filters.item_set`. | | `quality` | `string`, `null` | Атрибут качества предмета, например, StatTrak™ или Souvenir. Соответствует ключам `filters.quality`. | | `rarity` | `string`, `null` | Уровень редкости предмета. Соответствует ключам `filters.rarity`. | | `exterior` | `string`, `null` | Уровень внешнего износа для скинов оружия. Соответствует ключам `filters.exterior`. | | `phase` | `string`, `null` | Фаза Доплера для определённых раскрасок ножей. Соответствует ключам `filters.phase`. | | `tournament` | `string`, `null` | Название турнира, связанного с предметом (например, для мажорных стикеров, пропусков). | | `color` | `string`, `null` | Конкретный цвет для предметов граффити. | ### Объект `paint` Этот объект содержит свойства, относящиеся к визуальному паттерну и износу предмета. | Поле | Тип | Описание | | :-------- | :--------------- | :------------------------------------------------------------------------------------------------------ | | `float` | `number`, `null` | Значение представляющее износ предмета (от 0.0 до 1.0). | | `seed` | `number`, `null` | ID покраски, влияющее на вариации паттерна. | | `index` | `number`, `null` | Индекс покраски, для конкретных вариаций. | | `pattern` | `number`, `null` | ID паттерна для предметов с отличительными визуальными паттернами (скины, наклейки, нашивки, граффити). | ### Массив `attachments` Этот массив представляет прикрепления (наклейки, нашивки), которые могут быть *применены к предмету*. Для расходуемых прикреплений (таких как сами предметы-наклейки, нашивки или граффити) он описывает прикрепление, *содержащееся в предмете*. Массив всегда будет иметь фиксированную длину 5 элементов (максимальное количество слотов для наклеек/нашивок в CS2). Каждый элемент будет либо объектом `Attachment`, либо `null`, если слот пуст. Для расходуемых предметов, таких как Наклейка, Нашивка или Граффити, массив `attachments` будет содержать одну запись в слоте `0`, описывающую собственный паттерн предмета. Это соответствует тому, как Steam представляет эти данные. #### Структура объекта `Attachment` | Поле | Тип | Описание | | :------ | :--------------- | :----------------------------------------------------------- | | `id` | `number`, `null` | Внутренний ID наклейки/нашивки/граффити. | | `name` | `string`, `null` | Отображаемое название наклейки/нашивки/граффити. | | `image` | `string`, `null` | URL-адрес изображения наклейки/нашивки/граффити. | | `wear` | `number`, `null` | Значение износа (стирания) для *применённой* наклейки. | | `type` | `string` | Тип прикрепления. ( `sticker`, `patch`, `graffiti_pattern` ) | # API подарков Source: https://steamgold.dev/gifts Как купить Steam-игру в подарок другому пользователю через ссылку для добавления в друзья API подарков позволяет купить Steam-игру и отправить её другому пользователю через ссылку для добавления в друзья Steam. Покупка происходит через намерение — сначала создаётся намерение, затем выставляется счёт на оплату. Перед тем как создавать намерение, вы можете проверить доступность игры и получить актуальную цену с помощью метода [проверки подарка](/api-docs/gifts/verify). Для того чтобы получить список доступных игр в каталоге, используйте [метод загрузки каталога](/api-docs/gifts/catalog). Для получения информации о конкретной игре и её изданиях используйте [метод получения информации об игре](/api-docs/gifts/game). ```json theme={null} { "games": [ { "appId": 292030, "slug": "steam-292030", "title": "The Witcher 3: Wild Hunt", "headerImage": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/header.jpg", "shortDescription": "You are Geralt of Rivia, mercenary monster slayer.", "genres": ["RPG"], "price": { "paymentAmount": 199900, "paymentCurrency": "RUB", "paymentAmountFull": 299900, "discountPercent": 33 } } ], "total": 42 } ``` ### Работа с изданиями У каждой игры может быть несколько изданий (стандартное, делюкс, полное). Для просмотра всех доступных изданий и их цен используйте [метод получения информации об игре](/api-docs/gifts/game) с `appId` нужной игры. ```json theme={null} { "appId": 292030, "slug": "steam-292030", "type": "game", "isDlc": false, "isFree": false, "requiredAge": 0, "title": "The Witcher 3: Wild Hunt", "shortDescription": "You are Geralt of Rivia, mercenary monster slayer.", "website": "https://thewitcher.com/en/witcher3", "media": { "header": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/header.jpg", "capsule": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/capsule_231x87.jpg", "background": "https://store.akamai.steamstatic.com/images/storepagebackground/app/292030", "screenshots": [ { "thumbnail": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/ss_1.600x338.jpg", "full": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/ss_1.1920x1080.jpg" } ] }, "genres": ["RPG"], "categories": ["Single-player", "Steam Achievements", "Full controller support"], "developers": ["CD PROJEKT RED"], "publishers": ["CD PROJEKT RED"], "release": { "date": "18 May, 2015", "comingSoon": false }, "platforms": { "windows": true, "mac": false, "linux": false }, "metacritic": { "score": 92, "url": "https://www.metacritic.com/game/the-witcher-3-wild-hunt/" }, "recommendations": 850000, "achievements": 78, "editions": [ { "edition": "Standard Edition", "packageId": 40499, "regions": [ { "region": "US", "paymentAmount": 199900, "paymentCurrency": "RUB", "paymentAmountFull": 299900, "discountPercent": 33 } ] } ] } ``` При создании намерения необходимо передать `packageId` выбранного издания в поле `target.packageId`. ### Работа с регионом Поле `target.region` — двухбуквенный код страны по ISO 3166-1 alpha-2 (например, `US`, `DE`, `TR`). Регион влияет на доступность и цену игры. Рекомендуется запрашивать у геймера его регион или определять его автоматически. ### Как работает доставка После успешной оплаты наша система автоматически добавляется в друзья через переданную ссылку (`target.inviteUrl`) и отправляет игру в подарок. Геймер получает подарок в своей библиотеке Steam. # Введение Source: https://steamgold.dev/introduction Добро пожаловать в документацию API Стимголд! Hero Light Hero Dark ## Настройка Что нужно сделать, чтобы начать работу с API. Получите ключи для доступа к нашему API Используйте тестовые данные для проверки работы API # API корзины Source: https://steamgold.dev/pouch Как выставить один счет сразу за несколько заказов Корзина — это система для группировки нескольких намерений покупки (Intents) в единый заказ с общей оплатой. Система позволяет: * Собирать несколько товаров в одну корзину * Оплачивать все товары одним платежом * Управлять составом корзины до момента оплаты ## Основные концепции ### Модель Корзины Корзина представляет собой контейнер для намерений со следующими основными характеристиками: **Статусы корзины:** * `open` — корзина открыта для изменений * `closed` — корзина закрыта (после оплаты или истечения времени жизненного цикла) * `delivered` — товары доставлены * `failed` — ошибка при обработке **Статусы оплаты:** * `created` — корзина создана, оплата не инициирована * `pending` — выставлен счет, ожидается оплата * `paid` — оплата успешно завершена * `rejected` — оплата отклонена * `canceled` — оплата отменена * `refunded` — средства возвращены * `expired` — время на оплату истекло При [запросе корзины](/api-docs/pouch/get) возвращается полный список содержащихся в ней намерений со всей информацией по каждому. ### Особенности намерений в корзине * **Запрет индивидуальной оплаты** — намерения, связанные с корзиной, не могут проходить через стандартный процесс чекаута. При попытке вызова `POST /(gold|items|gear)/{id}/checkout` для такого намерения возвращается ошибка. * **Общий терминал оплаты** — все намерения в одной корзине должны использовать одинаковый платежный терминал. Это требование обеспечивает возможность создания единого счета. * **Синхронизация статусов** — статусы намерений синхронизируются со статусом корзины: * при оплате корзины все намерения помечаются как оплаченные; * при отмене или истечении времени жизни корзины все намерения получают соответствующий статус; * при изменении статуса корзины рассылаются оповещения по каждому намерению. ## Алгоритм работы При [создании намерения](/workflow#создание-намерения) проверяется аккаунт геймера на возможность пополнения и доступность товара. В ответе на запрос содержится статус проверки намерения и его идентификатор. Корзина может быть создана сразу при первом посещении пользователем сайта. Рекомендуется создавать корзину в момент, когда она становится необходимой. Подробнее в соответствующем [методе создания корзины](/api-docs/pouch/create). Используя `ID` корзины и намерения, полученные на предыдущих шагах, воспользуйтесь соответствующим [методом добавления намерения](/api-docs/pouch/add-intent), чтобы поместить намерение в корзину. Данный этап не является обязательным, но может быть полезен для создания более отзывчивого фронтенда. Подробнее в соответствующем [методе проверки корзины](/api-docs/pouch/verify). Блокирует дальнейшие изменения корзины и возвращает ссылку на платежную форму. Подробнее в соответствующем [методе выставления счета](/api-docs/pouch/checkout). После оплаты мы обрабатываем оповещение от платежной системы и автоматически зачисляем средства на счет или отправляем покупку. ## Получение ссылки на оплату Для получения ссылки на платежную форму воспользуйтесь методом [выставления счета за корзину](/api-docs/pouch/checkout). ```json theme={null} { "code": 200, "paymentId": "b3d9f8e2-1c4e-4f5a-9f7e-2a1b0c3d4e5f", "paymentUrl": "https://securepayments.tinkoff.ru/g0ld3Nj0y3R", "message": "Payment initiated" } ``` В ответе содержится ссылка на платежную форму, которую нужно передать геймеру для оплаты. ### Информация о доставки для физических товаров Для физических товаров в данный момент доступен только один способ доставки — СДЭК. Вам потребуется на своем сайте [установить их виджет](https://github.com/cdek-it/widget/wiki/%25D0%25A3%25D1%2581%25D1%2582%25D0%25B0%25D0%25BD%25D0%25BE%25D0%25B2%25D0%25BA%25D0%25B0-3.0) и передавать данные из него вместе с запросом чекаута корзины. Подробнее смотрите в [документации метода выставления счета](/api-docs/pouch/checkout). Имейте в виду, что мы не занимаемся доставкой физических товаров! ## Результаты транзакции Есть два способа узнать результат транзакции: * **Webhook** — на ваш сервер отправляется уведомление о результате транзакции, содержащее информацию о статусе транзакции по каждому намерению. Подробнее о методе webhook можно прочитать в разделе [получение оповещений](/webhooks). * **Проверка статуса** — вы можете отправить запрос на проверку статуса транзакции для каждого [отдельного намерения](/api-docs/gold/status) или для [корзины целиком](/api-docs/pouch/get). ## Жизненный цикл корзины Жизненный цикл корзины отличается от [обычных намерений](/workflow#%D0%B6%D0%B8%D0%B7%D0%BD%D0%B5%D0%BD%D0%BD%D1%8B%D0%B9-%D1%86%D0%B8%D0%BA%D0%BB-%D0%BD%D0%B0%D0%BC%D0%B5%D1%80%D0%B5%D0%BD%D0%B8%D1%8F). Основное отличие в том, что старт жизненного цикла корзины запускается после выставления счета, а не после создания. Также намерения внутри корзины перестают иметь собственный жизненный цикл и начинают зависеть от цикла корзины — в момент "протухания" корзины намерения тоже меняют свой статус на `expired`. Корзина имеет ограниченный срок жизни — **1 час с момента выставления счета**. Это означает: * У пользователя есть 1 час, чтобы завершить оплату. * По истечении времени корзина автоматически переходит в `{status: "closed", paymentStatus: "expired"}`. А все содержащиеся в ней намерения меняют статус на `expired`, и на указанный `callbackUrl` отправляется webhook с информацией о просрочке намерения. * Оплатить просроченную корзину невозможно — необходимо создать новую. Если после создания корзины в течение 3 дней в нее не будут добавлены намерения, такая корзина будет удалена. # Промокоды Source: https://steamgold.dev/promo Управление промокодами ## Создание промокода Сейчас нет возможности создавать промокоды через API — для создания промокодов обратитесь к вашему менеджеру. Промокоды работают регистронезависимо, то есть `PROMO` и `promo` — это один и тот же промокод. Мы сами приводим его к нужному регистру, поэтому вы можете отправлять промокод так как его ввел пользователь. #### Типы скидок Промокоды поддерживают следующие виды скидок: * `commission` — снижение комиссии на пополнение; Скидка не может привышать минимальную комиссию на пополнение, оговоренную в договоре. Если скидка будет больше, то она будет уменьшена до минимальной комиссии. #### Виды ограничений В промокодах можно указать следующие ограничения: * `expires` — дата и время окончания действия промокода; Если на момент создания намерения промокод не будет действителен или соответствовать другим ограничениям, то он будет проигнорирован. ## Проверка промокода Для того чтобы проверить промокод вам необходимо выполнить запрос к методу `POST /promo/verify` подробнее о методе можно узнать в [документации](/api-docs/promo/verify). В ответ вы получите информацию о промокоде, его типе и сумме скидки. Которую вы можете показать пользователю в вашем приложении. ## Применение промокода Применить промокод можно при создании намерения. Для этого вам необходимо передать промокод в поле `code` в запросе на пополнение или покупку. Подробнее о методе можно узнать: * [В документации пополнения](/api-docs/gold/create); * [В документации покупки](/api-docs/item/create); # Тестирование Source: https://steamgold.dev/staging Настройка тестового доступа Набор ключей будет содержать две пары ключей для доступа к API. Первая пара ключей будет для тестовых запросов к API, а вторая для боевых. Подробнее о передаче ключей в заголовке запроса вы можете прочитать в разделе [получение доступа](/api-docs/auth). Запросы для тестирования и для боевого использования нужно отправлять на один и тот же адрес: `https://api.steamgold.dev`. Разница только в ключах доступа. Тестовые ключи можно точно также обновлять используя запрос на [обновление ключа](/api-docs/auth/refresh). ### Тестирование верификации В тестовой среде верификацию можно проверить отправив разные значения в поле `account` в запросе на создание намерения. Подробнее о методе создания намерения вы можете прочитать в разделе [создание намерения](/api-docs/gold/create). Для успешной верификации аккаунта в поле `account` в запросе на создание намерения нужно передать значение `goldEnjoyer`. Для неуспешной верификации аккаунта в поле `account` в запросе на создание намерения нужно передать значение `diamondsFan`. Результат верификации можно узнать из поля `verified` в ответе на запрос. Если поле `verified` равно `true`, значит аккаунт подходит для пополнения. Если поле `verified` равно `false`, значит аккаунт не подходит для пополнения. ### Тестирование оплаты В тестовой среде оплата выставляется в тестовый терминал платежной системы и для тестирования можно использовать тестовые карты. Подробнее о методе оплаты вы можете прочитать в разделе [выставление счета](/api-docs/gold/checkout). Для успешной оплаты в тестовом терминале платежной системы нужно использовать карту с номером `4300 0000 0000 0777` с датой окончания `12/30` и кодом CVV `111`. Для неуспешной оплаты в тестовом терминале платежной системы нужно использовать карту с номером `5000 0000 0000 0009` с датой окончания `12/30` и кодом CVV `111`. В зависимости от результата оплаты, платежная форма перенаправит пользователя на разные адреса. Настройка страниц успешной и неуспешной оплаты в тестовом терминале платежной системы производится в настройках терминала. # API товаров Source: https://steamgold.dev/treasures Как узнать какие товары доступны для покупки до создания намерения Иногда товары могут быть временно недоступны из-за технических работ или других причин. Поэтому мы рекомендуем обновлять список доступных товаров и показывать актуальный статус на странице покупки — это удобнее для геймеров и не потребует ручного изменения списка с вашей стороны. Перед тем как создавать намерение, вы можете проверить доступность одного товара и получить его актуальную цену использовать метод [проверки доступности товара](/api-docs/items/verify). Для того чтобы получить список доступных товаров на платформе, можно использовать [метод загрузки списка товаров](/api-docs/treasures/items). В ответе на запрос будет содержаться список товаров, которые доступны для покупки с подробным описанием каждого товара. ```json theme={null} { "status": "200", "treasures": [ { "active": true, "inputParams": [ { "name": "account", "required": true, "title": "Введите player id" } ], "type": "item", "platform": "genshin-direct", "item": "60-genesis-crystals-asia", "icon": "genshin-genesis-crystal", "title": "60", "currency": "Genesis Crystals", "region": "asia" }, ... ] } ``` Полный список возможных полей: * **active** — флаг доступности товара * **inputParams** — параметры, которые необходимо передать при создании намерения * **type** — тип товара * **platform** — платформа, на которой доступен товар * **item** — идентификатор товара * **icon** — иконка товара (можно использовать иконку на нашем CDN: `https://cdn.steamgold.dev/items/{icon}.svg`) * **title** — название товара * **symbol** — символ валюты (если это ваучер в валюте, например: `₽`, `$`, `€`) * **currency** — название внутриигровой валюты (если это пополнение аккаунта) * **region** — регион, в котором доступен товар ### Работа с регионами Обычно, если платформа ограничивает доступ к товарам по регионам, то в ответе у каждого товара будет содержаться поле `region`, в котором будет указан регион, в котором доступен товар. Если товар не ограничен по регионам, то поле `region` будет отсутствовать. При создании намерения, вы должны передавать только идентификатор товара, без указания региона — регион нужен чтобы геймер мог выбрать подходящий товар для своего региона. ### Работа с полями ввода В поле `inputParams` содержится список параметров, которые необходимо передать при создании намерения. Эти параметры могут быть обязательными или необязательными. Если параметр обязателен, то в поле `required` будет значение `true`, иначе `false`. Иногда полем ввода для `account` может быть электронная почта, в таком случае вы можете либо в форме запрашивать почту для покупки и почту для чека, либо использовать одно поле для ввода почты и передавать его в параметре `account` и `email`. Если у товара больше одного обязательного поля, то все поля кроме `account` нужно передавать в `additionalFields` поле при работе с намерением. # Оповещения Source: https://steamgold.dev/webhooks Получение оповещений об оплате и закрытии намерений Для получения оповещений об оплате и закрытии намерений, вы можете использовать наш webhook. Webhook — это метод, который позволяет вашему серверу получать уведомления о событиях в нашей системе. ## Создание webhook Для получения оповещения вам нужно передать `callbackUrl` в запросе на создание намерения на пополнение счета. Подробнее о методе создания намерения вы можете прочитать в разделе [создание намерения](/api-docs/gold/create). ## Типы уведомлений ### Успешная оплата После получения подтверждения оплаты, на ваш сервер будет отправлено уведомление о результате транзакции. В уведомлении будет содержаться информация о статусе транзакции и дополнительные данные о транзакции. ```json theme={null} // Пример уведомления { "intentId": "5f4b3b4b-4b3b-4b3b-4b3b-4b3b4b3b4b3b", "intentAmount": 1000, "intentCurrency": "RUB", "verification": "verified", "payment": "paid", "paymentId": "8c3b21b5-3b21-3b21-3b21-9c3b21b5c3b2", "paymentAmount": 1250, "paymentCurrency": "RUB", "createdAt": "2024-16-10T12:00:00Z" } ``` ### Просроченное намерение При истечении срока жизни намерения, будет отправлено уведомление о смене статуса на `expired`. ```json theme={null} // Пример уведомления { "intentId": "5f4b3b4b-4b3b-4b3b-4b3b-4b3b4b3b4b3b", "intentAmount": 1000, "intentCurrency": "RUB", "verification": "verified", "payment": "expired", "paymentId": "8c3b21b5-3b21-3b21-3b21-9c3b21b5c3b2", "paymentAmount": 1250, "paymentCurrency": "RUB", "createdAt": "2024-16-10T12:00:00Z" } ``` ## Обратите внимание В оповещении содержится информация о намерении и платеже. Намерение — это запрос на пополнение счета, а платеж — это фактическая транзакция. Таким образом `intentAmount` и `intentCurrency` — это сумма и валюта запроса на пополнение, а `paymentAmount` и `paymentCurrency` — это сумма и валюта платежа. Прямо сейчас наша система не будет отправлять уведомления повторно, если ваш сервер не ответит на уведомление. Если вам нужна надежная система проверки статуса платежей, то рекомендуем использовать метод [проверки статуса намерения](/api-docs/gold/status). # Алгоритм работы Source: https://steamgold.dev/workflow Описание процесса выставления и оплаты счета Для пополнения счета вам необходимо создать намерение. Намерение — это запрос на пополнение счета или покупку товара, который вы создаете в нашей системе. После создания намерения, вы можете создать ссылку на платежную форму, на которой вы можете совершить оплату. Перед тем как создавать намерение, вы можете проверить возможность пополнения счета или доступность товара. Для этого можно использовать метод [проверки возможности пополнения](/api-docs/gold/verify) или [проверки доступности товара](/api-docs/items/verify). При создании намерения мы проверяем аккаунт геймера на возможность пополнения и доступность товара. В ответе на запрос будет содержаться статус проверки намерения и его идентификатор. Передавая идентификатор намерения, вы получаете ссылку на платежную форму, которую нужно передать геймеру для оплаты. После оплаты, мы обрабатываем оповещение от платежной системы и автоматически зачисляем средства на счет или отправляем покупку геймеру. ### Создание намерения Для создания намерения на пополнение счета, вам необходимо отправить POST запрос на адрес `/gold` или `/items`. Подробнее о методе создания намерения вы можете прочитать в разделе создание [намерения для пополнения](/api-docs/gold/create) или [намерения для покупки товара](/api-docs/items/create). ```json theme={null} // Обратите внимание на поле verified { "status": 200, "intentId": "5f7b1b4b-7b7b-4b7b-7b7b-7b7b7b7b7b7b", "verified": "true" } ``` Значение `true` в поле `verified` в ответе на запрос означает, что намерение прошло проверку и готово к оплате. Если поле `verified` равно `false`, значит такой аккаунт не может быть пополнен или товар недоступен. В ответе на запрос будет содержаться статус проверки намерения и его идентификатор. После получения идентификатора намерения, вы можете получить ссылку на платежную форму, на которой вы сможете оплатить пополнение счета. ### Получение ссылки на оплату Для получения ссылки на платежную форму, вам необходимо отправить POST запрос на адрес `/gold/{id}/checkout` или `/items/{id}/checkout`. В адресе запроса вы должны передать идентификатор намерения, который вы получили после создания намерения. Подробнее о методе получения ссылки на платежную форму вы можете прочитать в разделе выставление [счета на пополнение](/api-docs/gold/checkout) или [счета на покупку товара](/api-docs/items/checkout). ```json theme={null} { "code": 200, "paymentId": "5555555555", "paymentUrl": "https://securepayments.tinkoff.ru/g0ld3Nj0y3R", "message": "Payment initiated" } ``` В ответе на запрос будет содержаться ссылка на платежную форму, которую нужно передать геймеру для оплаты. ### Жизненный цикл намерения Намерение имеет ограниченный срок жизни — **1 час с момента создания**.
Это означает: * У пользователя есть 1 час, чтобы завершить оплату. * По истечении времени намерение автоматически переходит в статус `expired`. * Оплатить просроченное намерение невозможно — необходимо создать новое. * При смене статуса на `expired` на указанный `callbackUrl` отправляется webhook с информацией о просрочке намерения. Ограничение по времени защищает от курсовых рисков, связанных с задержкой оплаты. Если намерения находятся внутри корзины, то они перестают иметь собственный жизненный цикл и начинают зависеть от цикла корзины. Подробнее в разделе [жизненный цикл корзины](/pouch#жизненный-цикл-корзины). ### Результат транзакции Есть два способа узнать результат транзакции: * **Webhook** — на ваш сервер будет отправлено уведомление о результате транзакции, в котором будет содержаться информация о статусе транзакции. Подробнее о методе webhook вы можете прочитать в разделе [получение оповещений](/webhooks). * **Проверка статуса** — вы можете отправить запрос на проверку статуса транзакции, передав в теле запроса идентификатор намерения. Подробнее о методе проверки статуса вы можете прочитать в разделе [проверка статуса](/api-docs/gold/status).