RefundPurchase/v0001 (dokumentacja Steamworks)

Dokumentacja Steamworks

RefundPurchase/v0001

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

Wywołana przez Steam po tym, jak użytkownik wysłał prośbę o zwrot pieniędzy i została ona zatwierdzona przez Pomoc techniczną Steam. Implementacja powinna usuwać zakupione przedmioty z konta użytkownika. Zwykle będzie to wywoływane tylko raz dla każdej prośby o zwrot, ale możliwe są kolejne wywołania dla tego samego zakupu, jeśli na przykład Steam nie odczyta odpowiedzi za pierwszym razem. Implementacja powinna działać w taki sposób, aby oba wywołania powiodły się.

Wywoływana przez: zwroty pieniędzy na Steam

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 zakupem. Będzie to ID aplikacji dla twojej gry.
steamid	uint64	✔	64-bitowe ID Steam użytkownika, który dokonał zakupu.
orderid	uint64	✔	Unikalne 64-bitowe ID zamówienia. Jest ono identyczne z tym ID, które zostało wysłane do nas w wywołaniu ISteamMicroTxn/InitTxn.
force	bool	✔	Ma wartość „true”, jeśli pracownik Pomocy technicznej Steam sprawdził transakcję, zobaczył, że niektóre produkty zostały oznaczone jako bezzwrotne, ale mimo to postanowił je zwrócić.

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” w panelu administratora aplikacji na stronie Steamworks.

Przykładowe wyjście

{ "result": { "success": true } }