4️⃣

4. Check Item Purchase Status

View the shop item purchase list.

Basic Information

GET /bill-store/v1.0/{{service_id}}/purchase/status/web
Host:
   https://api.onstove.com (LIVE)    
   https://api.gate8.com (SB)
Content-Type: application/json
JavaScript
복사

Request

Header

Name	Type	Required	Default Value	Example	Description
authorization	String	Y	-	{access_token}	Access token issued through user authentication ※ On the web, the "SUAT cookie value" is used
X-Lang	String	Y	-	ko	Language code
X-Nation	String	Y	-	KR	Country code
X-Timezone	String	Y	-	Asia/Seoul	Timezone
X-Utc-Offset	Int32	Y	-	540	UTC Offset
caller-id	String	Y	-	clientapp	API Caller Information Example: ServiceName_GAME_SERVER

Path Variable

Name	Type	Required	Default Value	Example	Description
service_id	String	Y	-	GAME_ID	Game ID issued by the studio

Paramater (Query String)

Name	Type	Required	Default Value	Example	Description
shop_key	String	Y	-	indie	Sales Channel Key
guid	Int64	Y	-	123456	If a GUID is available, enter the GUID. If not, enter the member_no.
txn_mst_no	Int64	Y	-	5683669676745096842	Order Master Number
ts	Int64	Y	-	1608252682229	timestamp

Response

Body

Name	Type	Required	Default Value	Example	Description
code	Integer	Y	-	0	Response code
message	String	Y	-	OK	Response message
value	Object	N	-		Response value

Value

Name	Type	Required	Default Value	Example	Description
status	bool	Y	-	1	Purchase Status
shop_key	String	N	-	indie	Sales Channel Key
product_infos	List<json object>	Y	-	-	Purchased Item Information
stove_charge_infos	List<json object>	Y	-	-	Charging Window Resource Usage History

product_infos

Name	Type	Required	Default Value	Example	Description
product_id	Int64	Y	-	1001	Platform-specific item ID
category_id	String	Y	-	061A30EC8C904CA	Category Key • Returns the item list for the entire category if NULL
total_quantity	Int32	Y	-	1	Total Product Sales Volume
member_quantity	Int32	N	-	1	Member Purchase Quantity
guid_quantity	Int32	N	-	1	guid purchase quantity

stove_charge_infos

Name	Type	Required	Default Value	Example	Description
charge_deduct_val	Decimal	Y	-	1000	Payment Price
charge_display_deduct_val	Decimal	Y	-	1000	Cash conversion price for settlement price
charge_type	Int32	Y	-	16	Payment Method Codes • 2: Coupon • 98: STOVE Cash • 99: Points • Others: PG Payment Methods
charge_type_name	String	Y	-	Mobile T-Money	Payment Method Name

Sample

Request

curl --location --request GET'https://api.onstove.com/bill-store/v1.0/{{service_id}}/purchase/status/web?shop_key=indie&character_no=1234&txn_mst_no=5683669676745096842' \
--header 'Authorization: Bearer {{access_token}}'
--header 'X-Lang: ko'
--header 'X-Nation: KR'
--header 'X-Timezone: Asia/Seoul'
--header 'X-Utc-Offset: 540'
--header 'caller-id: {{caller-id}}'
JavaScript
복사

Response

Content-Type : application/json

{
    "value": {
        "status": true,
        "shop_key": "indie_shop",
		"product_infos": [
            {				
				"product_id": 1884,
                "category_id": "B37E4AD7B4D84BF",
                "total_quantity": 1,
                "member_quantity": 1,
                "guid_quantity": 1
             }
        ],
        "stove_charge_infos": [
            {
                "charge_deduct_val": 15000,
                "charge_display_deduct_val": 15000,
                "charge_type",
                1,
                "charge_type_name": "POQ Cashbee"
            },
            {
                "charge_deduct_val": 8100.0,
                "charge_display_deduct_val": 8100.0,
                "charge_type": 98,
                "charge_type_name": "Stove Cash"
            },
            {
                "charge_deduct_val": 8100.0,
                "charge_display_deduct_val": 8100.0,
                "charge_type": 99,
                "charge_type_name": "Point"
            },
            {
                "charge_deduct_val": 8100.0,
                "charge_display_deduct_val": 8100.0,
                "charge_type": 2,
                "charge_type_name": "优惠券"
            }
        ]
     },
    "code": 0,
    "message": "OK"
}
JavaScript
복사

Response Failure Example

{
  "code": "999999",
  "message": "An undefined error."
}
JavaScript
복사

Return Code

HTTP Status code	response_code	response_message	Description
200	0	OK	Success
200	999999	An undefined error.	Item Shop API Error
500	500	Internal Server Error	Internal server error