QueryRefundAllowed/v0001(Steamworks 문서)

Steamworks 문서

QueryRefundAllowed/v0001

Steamworks 문서 > 기능 > Steam 보관함 서비스 > Steam 경제 > QueryRefundAllowed/v0001

사용자가 고객 지원 사이트를 방문하여 게임 내 구매와 관련된 추가 정보를 얻으려 할 때 호출됩니다. 응답에는 구매와 연관된 아이템의 현재 상태 및 각 아이템의 현재 환불 가능 여부가 포함됩니다.

호출: Steam 환불

HTTP 메서드: GET

매개변수:

이름	종류	필수	설명
key	string	✔	이것은 귀하가 파트너 사이트에 제공한 귀사 앱의 Steam 경제 설정에 있는 "자산 서버 키"입니다.
appid	uint32	✔	구매와 연관된 애플리케이션의 32비트 앱 ID. 이는 게임의 앱 ID가 됩니다.
steamid	uint64	✔	구매한 사용자의 64비트 Steam ID
language	string	✔	ISO639-1 언어 코드에 문자열을 반환할 언어의 ISO 3166-1 alpha 2 국가 코드. 일부 예시: en_US, de_DE, zh_CN, and ko_KR. 기본값: en_US
orderid	uint64	✔	주문에 대한 고유 64비트 ID. ISteamMicroTxn/InitTxn 호출에서 받은 것과 동일한 주문 ID입니다.

반환값

이 메서드의 출력은 JSON 형식으로 인코딩되어야 합니다.

응답:

결과
- success - 메서드가 성공일 때 true. 에셋 서버가 false를 반환하면, 그 원인을 설명하는 error를 문자열에 설정해야 합니다.
- error - 실패 원인을 설명하는 문자열. 이 메시지는 Steamworks 사이트의 경제 탭에 있는 오류 이력에 기록됩니다.
- assets - 구매한 라인 아이템의 모음.
  - itemtypeid - 아이템의 게임 ID 번호. ISteamMicroTxn/InitTxn 호출에서 받은 것과 동일한 itemid 값입니다.
  - allow_refund - 구매한 아이템을 사용, 변경, 양도하지 않았을 경우 반드시 true입니다.
  - in_inventory - 구매한 사용자가 여전히 아이템을 소유한 경우 true.
  - bundle - 만약 사용자가 구매한 아이템이 실제로 추가 아이템을 포함한 번들이라면, 이 값을 true로 설정하고 번들로 제공된 아이템을 다음 입력 항목으로 assets 모음에 포함하세요.
  - current_state - 사용자가 읽을 수 있는 아이템의 현재 상태 문자열. 사용자에게 표시되므로 가능하면 현지화되어야 합니다. 특히 allow_refund가 false일 경우 구체적일수록 좋습니다. ‘2015년 3월 25일에 다른 아이템을 제작할 때 사용됨’ 혹은 ‘보관함에 있음’과 같은 형태일 수 있습니다.
  - item_name - 아이템의 이름. 사용자에게 표시되므로 가능하면 현지화되어야 합니다.
  - amount - 아이템의 구매 수량. 모든 아이템의 id는 동일해야 합니다(게임이 Steam 경제 API를 지원하지 않을 경우는 제외). 다른 id 값을 가진 다수의 아이템을 구매한 경우, 금액란을 사용하는 대신 assets array에 복수 항목을 포함하세요.
    
    참고: 아래 항목들은 게임이 저희가 제공하는 Steam Economy APIs를 지원하는 경우에만 적용됩니다.
  - id - 사용자에게 제공된 아이템의 assetid 혹은 currencyid.
  - contextid - 아이템이 위치한 contextid.
  - currency - id가 currencyid를 의미할 경우 true.
  - class - 게임에 정의된 에셋 클래스 식별자 모음. GetAssetClass/v0001에서 반환하는 것과 동일한 클래스여야 합니다.

예시 출력

{ "result": { "assets": [ { "itemtypeid": 594, "contextid": 2, "currency": false, "amount": 1, "id": 3837860447, "class": [ { "name": "def_index", "value": "594" }, { "name": "flags", "value": "16" }, { "name": "origin", "value": "2", "instance": true }, { "name": "@tradable after date", "value": "1434493482", "instance": true } ] , "allow_refund": true, "in_inventory": true, "bundle": false, "current_state": "In your inventory", "item_name": "The Phlogistinator" }, { "itemtypeid": 214, "contextid": 2, "currency": false, "amount": 1, "id": 3837860448, "class": [ { "name": "def_index", "value": "214" }, { "name": "flags", "value": "16" }, { "name": "origin", "value": "2", "instance": true }, { "name": "@tradable after date", "value": "1434493482", "instance": true } ] , "allow_refund": true, "in_inventory": true, "bundle": false, "current_state": "In your inventory", "item_name": "The Powerjack" } ] , "success": true } }