FinalizeWebAssetTransaction/v0001 (документация Steamworks)

Документация Steamworks

FinalizeWebAssetTransaction/v0001

Документация Steamworks > Список возможностей > Служба инвентаря Steam > Экономика Steam > FinalizeWebAssetTransaction/v0001

Вызывается после того, как пользователь заплатил за предметы, указанные в транзакции.
Реализация на сервере должна вызвать ISteamMicroTxn/FinalizeTxn прежде, чем передавать предметы пользователю.

Вызываются: веб-покупки

Метод HTTP: POST

Параметры:

Название	Тип	Обязательно?	Описание
key	string	✔	Это ключ сервера ресурсов, который вы предоставили в настройках раздела экономики своего приложения в Steam на партнёрском сайте.
appid	uint32	✔	32-битный номер приложения, к которому относится ресурс.
steamid	uint64	✔	64-битный SteamID пользователя, который совершает покупку.
language	string	✔	Языковой код ISO639-1 плюс код страны ISO 3166-1 alpha-2 для языка, на котором возвращать строки. К примеру: en_US, de_DE, zh_CN, ko_KR. По умолчанию: en_US
txnid	uint64	✔	Номер транзакции, возвращённый StartWebAssetTransaction/v0001
sandbox	uint32		Ненулевое значение, если эта транзакция будет использовать режим sandbox. При этом средства из кошелька пользователя вычитаться не будут. В этом случае следует вызвать функцию ISteamMicroTxnSandbox/FinalizeTxn вместо ISteamMicroTxn/FinalizeTxn. См. руководство по микротранзакциям, чтобы узнать больше.

Возвращаемые значения

Результат этого метода кодируется в .json.

Ответ:

result
- success — true, если метод успешен. Если сервер ресурсов возвращает false, будет также возвращено поле error с объяснением.
- error — объяснение сбоя. Это сообщение будет записано в журнал ошибок, который можно увидеть во вкладке «Экономика» раздела «Сообщество» настроек приложения на главной странице управления приложением в Steamworks.
- displaytext — необязательное сообщение об ошибке, показываемое пользователю.
- assets — массив ресурсов, сгенерированных для данной покупки.
  - assetid — 64-битный номер ресурса.
  - contextid — 64-битный номер контекста, к которому принадлежит ресурс.

Пример вывода

{ "result": { "success": true, "displaytext": "Your purchase is complete! Purchased items are now in your inventory.", "assets": [ { "assetid": 103, "contextid": 2 } ] } }