Steamworks 文獻庫
StartWebAssetTransaction/v0001
為使用者開始指定物品的交易。
實作中應呼叫 ISteamMicroTxn/InitTxn 以讓 Steam 設定交易並取得轉送網址。

呼叫方: 網頁購買

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。
asset[n]string代表使用者希望購賣的物品的字串, 可以是物品定義索引、物品名稱,或任何遊戲希望使用的獨特表述。 n 為從 0 開始的索引,使用者想購買的每一件物品均有一個索引。 其值應與 GetAssetPricesname 參數一致,且與使用者傳入的 buyitem 網址相同。
quantity[n]uint32可選用的無正負號整數,表示使用者想購買的第 N 件物品的數量。 如果購買的任何物品沒有此參數,則應假定為 1。
currencystring交易使用的 ISO 4217 貨幣代碼。
ipaddressstring使用者的 IP 位址,以字串表示。 IP 位址應與存取轉送網址的 IP 位址相同,交易全程也應保持不變。
referrerstring可選用的字串,含有將使用者引導至交易的網址。
sandboxuint32如果此交易將使用小額交易「沙盒」則為非 0 的值,將不會從使用者的錢包扣款。 在這種情況下,您應呼叫 ISteamMicroTxnSandbox/InitTxn 而非 ISteamMicroTxn/InitTxn。 詳細資訊請見小額交易實施應用指南

傳回

此方法的輸出應以 JSON 格式編碼。

回應:
  • result
    • success - 若方法成功,則為 True。 如果資產伺服器傳回 False,則會將 error 設為說明其原因的字串。
    • error - 說明呼叫失敗原因的字串。 此訊息將儲存於錯誤紀錄中。錯誤紀錄位於 Steamworks 網站中的「經濟」分頁之下。
    • displaytext - 經在地化的錯誤訊息,可選擇向使用者顯示。
    • url - 將使用者轉送至繼續交易程序的網址。 此網址應受到 returnurl 參數的修改,以指定使用者授權交易後應被轉送前往何處, 並且應為最終呼叫 FinalizeWebAssetTransaction 的網址。 returnurl 參數的值也應包含呼叫 FinalizeWebAssetTransaction 時所需的交易 ID。
      另外,也可以指定 cancelledurl 參數,以指定如果使用者取消而非授權交易,將被轉送至何處。
    • txnid - InitTxnorderid 參數使用的交易 ID。

輸出範例

{ "result": { "success": true, "url": "https://store.steampowered.com/checkout/approvetxn/229984771771125/", "txnid": "72" } }