샵 아이템 구매 목록을 조회합니다.
기본정보
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 ※ Web에서는 “SUAT 쿠키값” 사용 |
X-Lang | String | Y | - | ko | 언어 코드 |
X-Nation | String | Y | - | KR | 국가 코드 |
X-Timezone | String | Y | - | Asia/Seoul | Timezone |
X-Utc-Offset | Int32 | Y | - | 540 | UTC Offset |
caller-id | String | Y | - | clientapp | API 호출자 정보
예) 서비스명_GAME_SERVER |
Path Variable
Name | Type | Required | Default Value | Example | Description |
service_id | String | Y | - | GAME_ID | 스튜디오에서 발급된 게임ID |
Paramater (Query String)
Name | Type | Required | Default Value | Example | Description |
shop_key | String | Y | - | indie | 판매 채널 키 |
guid | Int64 | Y | - | 123456 | Guid가 있는 경우 GUID 입력
없으면 member_no 입력 |
txn_mst_no | Int64 | Y | - | 5683669676745096842 | 주문 마스터 번호 |
ts | Int64 | Y | - | 1608252682229 | timestamp |
Response
Body
Name | Type | Required | Default Value | Example | Description |
code | Integer | Y | - | 0 | 응답 코드 |
message | String | Y | - | OK | 응답 메시지 |
value | Object | N | - | 응답 값 |
Value
Name | Type | Required | Default Value | Example | Description |
status | bool | Y | - | 1 | 구매 상태 |
shop_key | String | N | - | indie | 판매 채널 키 |
product_infos | List<json object> | Y | - | - | 구매 상품 정보 |
stove_charge_infos | List<json object> | Y | - | - | 충전 창 재화 사용 내역 |
product_infos
Name | Type | Required | Default Value | Example | Description |
product_id | Int64 | Y | - | 1001 | 플랫폼 고유 아이템 ID |
category_id | String | Y | - | 061A30EC8C904CA | 카테고리 키
• NULL 일 경우 전체 카테고리에 대한 아이템 리스트 리턴 |
total_quantity | Int32 | Y | - | 1 | 상품 총 판매수량 |
member_quantity | Int32 | N | - | 1 | 회원 구매 수량 |
guid_quantity | Int32 | N | - | 1 | guid 구매 수량 |
stove_charge_infos
Name | Type | Required | Default Value | Example | Description |
charge_deduct_val | Decimal | Y | - | 1000 | 결제 가격 |
charge_display_deduct_val | Decimal | Y | - | 1000 | 결제 가격에 대한 캐시 전환 가격 |
charge_type | Int32 | Y | - | 16 | 결제 수단 코드
• 2: 쿠폰
• 98: STOVE 캐시
• 99: 포인트
• 그 외: PG 결제 수단 |
charge_type_name | String | Y | - | 모바일티머니 | 결제 수단 명 |
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 캐시비"
},
{
"charge_deduct_val": 8100.0,
"charge_display_deduct_val": 8100.0,
"charge_type": 98,
"charge_type_name": "스토브 캐시"
},
{
"charge_deduct_val": 8100.0,
"charge_display_deduct_val": 8100.0,
"charge_type": 99,
"charge_type_name": "포인트"
},
{
"charge_deduct_val": 8100.0,
"charge_display_deduct_val": 8100.0,
"charge_type": 2,
"charge_type_name": "쿠폰"
}
]
},
"code": 0,
"message": "OK"
}
JavaScript
복사
응답 실패 예제
{
"code": "999999",
"message": "정의되지 않은 오류입니다."
}
JavaScript
복사
Return Code
HTTP Status code | response_code | response_message | Description |
200 | 0 | OK | 성공 |
200 | 999999 | 정의되지 않은 오류입니다. | 아이템 샵 API 오류 |
500 | 500 | Internal Server Error | 서버 내부 오류 |