StartWebAssetTransaction/v0001 (dokumentacja Steamworks)

Dokumentacja Steamworks

StartWebAssetTransaction/v0001

Dokumentacja Steamworks > Funkcje > Usługa Ekwipunku Steam > Ekonomia Steam > StartWebAssetTransaction/v0001

Rozpoczyna transakcję w imieniu użytkownika dla określonych przedmiotów.
Implementacje powinny wywoływać ISteamMicroTxn/InitTxn, by Steam mógł skonfigurować transakcję i otrzymać URL do przekazania dalej.

Wywoływana przez: zakupy internetowe

Metoda HTTP: POST

Parametry:

Nazwa	Typ	Wymagane?	Opis
key	string	✔	Jest to klucz serwera zasobów, który podano w ustawieniach Ekonomii Steam twojej aplikacji na stronie partnerskiej.
appid	uint32	✔	32-bitowe ID aplikacji powiązanej z zasobem.
steamid	uint64	✔	64-bitowe ID Steam użytkownika, dla którego przygotowywana jest transakcja.
language	string	✔	Kod języka ISO639-1 oraz kod kraju ISO 3166-1 alfa-2 dla języka, w którym należy zwrócić stringi, np. en_US, de_DE, zh_CN i ko_KR. Domyślnie: en_US.
asset[n]	string	✔	String oznaczający przedmiot, który użytkownik chce kupić. Może to być indeks definicji przedmiotu, nazwa przedmiotu lub inna dowolna unikalna reprezentacja używana przez grę. `n` jest indeksem zaczynającym się od 0 i każdy przedmiot zakupiony przez użytkownika posiada po jednym z nich. Wartość powinna być zgodna z parametrem `name` w `GetAssetPrices` oraz jest tym samym stringiem przekazywanym przez użytkownika do adresu URL buyitem.
quantity[n]	uint32		Opcjonalna wartość całkowita bez znaku określająca liczbę n-tego przedmiotu, który użytkownik chce kupić. Jeśli nie ma parametru dla dowolnego nabywanego przedmiotu, należy przyjąć wartość 1.
currency	string	✔	Kod waluty (zgodny z normą ISO 4217), która zostanie wykorzystana do transakcji.
ipaddress	string	✔	Adres IP użytkownika jako string. Oczekuje się, że adres IP będzie zgodny z adresem IP, który będzie miał dostęp do przekierowującego łącza i że pozostanie taki sam podczas całej transakcji.
referrer	string		Opcjonalny string zawierający łącze, z którego użytkownik został przekierowany do transakcji.
sandbox	uint32		Jeśli wartość będzie inna niż zero, ta transakcja wykorzysta środowisko testowe (tzw. sandbox) mikrotransakcji, dzięki czemu żadne środki nie zostaną pobrane z portfela użytkownika. W takim wypadku wywołaj ISteamMicroTxnSandbox/InitTxn zamiast ISteamMicroTxn/InitTxn. Przejdź tutaj, aby uzyskać więcej informacji.

Wartości zwrotne

Wynik tej metody powinien być zakodowany w formacie JSON.

Odpowiedź:

result
- success – wartość „true”, jeśli metoda zakończy się powodzeniem. Jeśli serwer zasobów zwraca wartość „false”, to powinien ustawić error jako string z wyjaśnieniem dlaczego.
- error – string wyjaśniający, dlaczego to wywołanie nie powiodło się. Ta wiadomość zostanie zapisana w dzienniku błędów, który jest dostępny w zakładce „Ekonomia” na stronie Steamworks.
- displaytext – opcjonalny zlokalizowany komunikat o błędzie wyświetlany użytkownikowi.
- url – adres URL, do którego użytkownik ma zostać przekierowany, by kontynuować transakcję. Parametr adresu URL
  musi zostać uzupełniony przez parametr returnurl, który określa, dokąd przekierować użytkownika po
  autoryzacji transakcji. Ten adres powinien być tym, który ostatecznie wywołuje
  FinalizeWebAssetTransaction. Wartość parametru „returnurl” powinna również zawierać
  ID transakcji, ponieważ będzie ono wymagane podczas wywoływania FinalizeWebAssetTransaction.
  Dodatkowo można określić parametr „cancelledurl”, który określa, gdzie przekierować użytkownika, jeśli
  anuluje on transakcję zamiast ją autoryzować.
- txnid – ID transakcji w postaci, w jakiej zostało przekazane do parametru orderid z
  InitTxn.

Przykładowe wyjście

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