Steamworks 文獻庫
FinalizeWebAssetTransaction/v0001
使用者為交易物品付款完畢後呼叫。
實作時,應該在嘗試將物品交予使用者前呼叫 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如果此交易將使用小額交易「沙盒」則為非 0 的值,將不會從使用者的錢包扣款。 在這種情況下,您應呼叫 ISteamMicroTxn/FinalizeTx 而非 ISteamMicroTxnSandbox/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 } ] } }