FinalizeWebAssetTransaction/v0001 (Steamworks-Dokumentation)

Steamworks-Dokumentation

FinalizeWebAssetTransaction/v0001

Steamworks-Dokumentation > Funktionen > Steam-Inventardienst > Steam-Wirtschaftssystem > FinalizeWebAssetTransaction/v0001

Wird aufgerufen, nachdem der Nutzer die Gegenstände in der Transaktion bezahlt hat.
Bei der Implementierung sollte ISteamMicroTxn/FinalizeTxn aufgerufen werden, bevor Gegenstände an den Nutzer vergeben werden.

Aufgerufen von: Webeinkäufe

HTTP-Methode: POST

Parameter:

Name	Typ	Erforderlich?	Beschreibung
key	string	✔	Dies ist der „Asset-Server-Schlüssel“, den Sie in den Steam-Wirtschaftseinstellungen Ihrer Anwendung auf der Partnerseite angegeben haben.
appid	uint32	✔	Die 32-Bit-App-ID der Anwendung, auf die sich das Element bezieht.
steamid	uint64	✔	Die 64-Bit-Steam-ID des Nutzers, der den Kauf tätigt.
language	string	✔	Der Sprachcode (ISO 639-1) sowie der Ländercode (ISO 3166-1 alpha 2) der Sprache des zurückgegebenen Strings. Beispiele: en_US, de_DE, zh_CN oder ko_KR. Standard: en_US.
txnid	uint64	✔	Die Transaktions-ID, die von StartWebAssetTransaction/v0001 zurückgegeben wurde.
sandbox	uint32		Dieser Wert ist nicht null, wenn die Transaktion die Mikrotransaktion „sandbox“ verwendet. In diesem Fall wird nichts vom Steam-Guthaben abgezogen. Rufen Sie in diesem Fall ISteamMicroTxnSandbox/FinalizeTxn statt ISteamMicroTxn/FinalizeTxn auf. Weitere Informationen finden Sie hier: Anleitung zur Implementation von Mikrotransaktionen.

Rückgabewert

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 einen String enthalten, in dem der Grund dafür erklärt wird.
- error – Ein String, der beschreibt, warum dieser Aufruf fehlgeschlagen ist. Diese Nachricht wird im Fehlerprotokoll aufgezeichnet, das in "Steamworks-Einstellungen bearbeiten" für Ihre App im Auswahlmenü "Community" unter der Option "Wirtschaft" verfügbar ist.
- displaytext – Eine optionale, lokalisierte Fehlermeldung, die dem Nutzer angezeigt wird.
- assets – Ein Array der Elemente, die für den Kauf generiert wurden.
  - assetid – Die 64-Bit-ID des Elements.
  - contextid – Die 64-Bit-ID des Kontexts, dem das Element angehört.

Beispielausgabe

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