Steamworks-Dokumentation
StartWebAssetTransaction/v0001
Beginnt eine Transaktion im Auftrag eines Nutzers für die angegebenen Gegenstände.
Bei der Implementierung sollte ISteamMicroTxn/InitTxn aufgerufen werden, damit Steam die Transaktion einrichtet und eine Weiterleitungs-URL bereitstellt.

Aufgerufen von: Webeinkäufe

HTTP-Methode: POST

Parameter:

NameTypErforderlichBeschreibung
keystringDies ist der „Asset-Server-Schlüssel“, den Sie in den Steam-Wirtschaftseinstellungen Ihrer Anwendung auf der Partnerseite angegeben haben.
appiduint32Die 32-Bit-App-ID der Anwendung, auf die sich das Element bezieht.
steamiduint64Die 64-Bit-Steam-ID des Nutzers, für den eine Transaktion eingerichtet werden soll.
languagestringISO639-1-Sprachcode plus ISO 3166-1-Alpha 2-Ländercode der Sprache, in der Strings zurückgegeben werden sollen. Beispiele: en_US, de_DE, zh_CN oder ko_KR. Standard: en_US.
asset[n]stringEin String, der einen Gegenstand darstellt, den der Nutzer kaufen möchte. Dies kann ein Index aus der Gegenstandsdefinition, ein Gegenstandsname oder eine beliebige andere eindeutige und im Spiel verwendete Bezeichnung sein. n ist ein 0-basierter Index. Es gibt einen pro Artikel, den der Nutzer kaufen möchte. Der Wert muss mit dem Wert des name Parameters von GetAssetPrices übereinstimmen und der gleiche String sein, den der Benutzer an die buyitem-URL übergibt.
quantity[n]uint32Ein optionaler Integer ohne Vorzeichen zur Angabe der Menge, die der Nutzer für den x-ten Gegenstand kaufen will. Wenn dieser Parameter bei einem gekauften Gegenstand fehlt, sollte der Wert 1 angenommen werden.
currencystringDer für die Transaktion verwendete Währungscode gemäß ISO 4217.
ipaddressstringDie IP-Adresse des Nutzers als String. Diese muss mit der IP-Adresse übereinstimmen, von der aus die Weiterleitungs-URL geöffnet wird, und muss über die gesamte Transaktionsdauer hinweg unverändert bleiben.
referrerstringEin optionaler String mit der URL, über die der Nutzer zur Transaktion weitergeleitet wurde.
sandboxuint32Dieser Wert ist nicht 0, wenn die Transaktion die Mikrotransaktion „sandbox‟ verwendet. In diesem Fall wird kein Betrag vom Steam-Guthaben abgezogen. In diesem Fall sollten Sie ISteamMicroTxnSandbox/InitTxn statt ISteamMicroTxn/InitTxn aufrufen. Weitere Informationen finden Sie hier: Anleitung zur Implementation von Mikrotransaktionen.

Rückgabewerte

Die Ausgabe dieser Methode sollte im JSON-Format kodiert sein.

Antwort:
  • result
    • success: „true“, wenn die Methode erfolgreich war. Wenn der Asset-Server „false“ zurückgibt, sollte error auf einen String eingestellt werden, der den Grund dafür erklärt.
    • error: Dieser String beschreibt, warum dieser Aufruf fehlgeschlagen ist. Diese Nachricht wird im Fehlerprotokoll aufgezeichnet, das im Tab „Wirtschaft“ auf der Webseite von Steamworks verfügbar ist.
    • displaytext: Eine optionale lokalisierte Fehlermeldung für den Nutzer.
    • url: die URL, die den Nutzer dorthin weiterleitet, wo die Transaktion fortgesetzt wird. Die URL
      sollte mit einem returnurl-Parameter abgeändert werden, der angibt, wohin der Nutzer
      nach Autorisierung der Transaktion weitergeleitet wird. Die URL sollte diejenige sein, die letztendlich
      FinalizeWebAssetTransaction aufruft. Der Wert des returnurl-Parameters sollte auch die
      Transaktions-ID enthalten, die für den Aufruf von FinalizeWebAssetTransaction verwendet wird.
      Darüber hinaus kann auch ein cancelledurl-Parameter angegeben werden, der festlegt,
      wohin der Nutzer weitergeleitet wird, wenn dieser die Transaktion abbricht.
    • txnid: Die Transaktions-ID, wie sie an den orderid- Parameter von
      InitTxn übertragen wurde.

Beispielausgabe

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