Steamworks 文献库
FinalizeWebAssetTransaction/v0001
在交易时当用户为物品付款之后调用此 API。
具体实现应在将物品交付用户之前先调用 ISteamMicroTxn/FinalizeTxn

调用方: 网页购买

HTTP 方法: POST

参数:

名称类型是否必需描述
keystring这是在合作伙伴网站上,您在自己应用的 Steam 经济体设置中提供的“资产服务器密钥”。
appiduint32与资产相关联的应用程序的 32 位 App ID。
steamiduint64进行购买的用户的 64 位 Steam ID。
languagestring返回的字符串所使用语言的 ISO639-1 语言代码加 ISO 3166-1 alpha 2 国家代码。 如 en_US、de_DE、zh_CN、ko_KR 等。 默认为 en_US。
txniduint64StartWebAssetTransaction/v0001 返回的交易 ID。
sandboxuint32如果此交易使用不会从用户钱包中扣取资金的小额交易“sandbox”,则为非零。 在此情况下应调用 ISteamMicroTxnSandbox/FinalizeTxn,而不是 ISteamMicroTxn/FinalizeTxn。 参见小额交易实现指南,了解更多详情。

返回

此方法的输出应为 JSON 格式。

响应:
  • result
    • success - 如果方法成功,为 true。 如果资产服务器返回 false,应将 error 设置为解释原因的字符串 。
    • error - 描述为何此调用失败的字符串。 这条消息将记录入错误日志,您可以在 Steamworks 应用登录页面点击“Steamworks 设置”,然后点击“社区”->“经济体”进行查看。
    • displaytext - 显示给用户的本地化错误消息,可选择性使用。
    • assets - 为购买生成的一组资产。
      • assetid - 资产的 64 位 ID。
      • contextid - 资产所属的上下文的 64 位 ID。

输出示例

{ "result": { "success": true, "displaytext": "购买已完成! 购买的物品现已在您的库存中。", "assets": [ { "assetid": 103, "contextid": 2 } ] } }