<aside>
💡 지급처(게임/모바일빌링/온라인빌링)에서 결제 유효성 여부를 체크할 때 사용됩니다.
표준 결제창을 이용한 빌링 연동시 member_no와 트랜잭션 번호로 해당 결제의 상세 정보를 조회하는데 사용됩니다.
</aside>
기본정보
GET /bill-cpm/v1.0/payment/{service_id}/detail
Host:
<https://api.onstove.com> (LIVE)
<https://api.gate8.com> (SB)
Content-Type: application/json
Request
Header
| Name |
Type |
Required |
Default Value |
Example |
Description |
| authorization |
String |
Y |
- |
Bearer {user access_token} |
사용자의 인증을 통해 발급 되는 user access token |
| caller-id |
String |
Y |
- |
{GAME_ID}_SERVER |
API 호출자 정보 |
Path Variable
| Name |
Type |
Required |
Default Value |
Example |
Description |
| service_id |
String |
Y |
- |
STOVE_GAME |
게임코드 (game_id) |
Parameter (Query String)
| Name |
Type |
Required |
Default Value |
Example |
Description |
| bill_platform_type |
string(16) |
Y |
- |
SHOP |
결제처 |
- MOBILE : 모바일 빌링
- SHOP: 상점(온라인 빌링) |
| noti_type | string(32) | N | - | SHOP_PURCHASE | notification 구분
-ONLINE_PURCHASE : 온라인일반상품 구매
-IAP_PURCHASE : 모바일 일반상품 구매
-IAP_SUBSCRIPT : 모바일 구독상품 구매
-IAP_OOAP : 모바일 OOAP 상품 구매
-ONLINE_CART_PURCHASE: 온라인장바구니상품 구매 |
| member_no | long | Y | - | - | 회원 번호 |
| tid | string(20) | Y | - | T202202103125 | 스토브 빌링에서 발급한 주문번호 (PC_SDK연동 시 TransactionDetailNo 값) |
Response
Body
| Name |
Type |
Required |
Default Value |
Example |
Description |
| code |
Integer |
Y |
- |
0 |
응답 코드 |
| message |
String |
Y |
- |
OK |
응답 메시지 |
| data |
Object |
N |
- |
- |
응답 값 |
data(온라인 상품, 모바일 상품)
| Name |
Type |
Required |
Default Value |
Example |
Description |
| tid |
string(20) |
Y |
- |
T202202103125 |
스토브 빌링에서 발급한 주문번호 |
| product_id |
string(20) |
Y |
- |
p1002 |
스토브 플랫폼에 등록한 상품 코드 |
| quantity |
Integer |
N |
1 |
20 |
개별 상품 수량 |
| product_price |
decimal |
Y |
- |
1100, 0.99 |
거래 금액 |
| product_currency |
string(3) |
Y |
- |
KRW, USD |
해당 금액의 통화 |
| txn_time |
long |
Y |
- |
1644489139000 |
결제 시각(Unix Timestamp UTC-0) |
| inservice_item_id |
string(30) |
Y |
- |
cp7892 |
게임내 아이템ID |
data(온라인 상품, 모바일 상품)
| Name |
Type |
Required |
Default Value |
Example |
Description |
| tid |
string(20) |
Y |
- |
T202202103125 |
스토브 빌링에서 발급한 주문번호 |
| products |
Array |
Y |
- |
- |
상품정보 |
| -장바구니 지원을 위해 Array로 구현 |
|
|
|
|
|
products
| Name |
Type |
Required |
Default Value |
Example |
Description |
| tid |
string(20) |
Y |
- |
T202202103125 |
스토브 빌링에서 발급한 주문번호 |
| product_id |
string(20) |
Y |
- |
p1002 |
스토브 플랫폼에 등록한 상품 코드 |
| quantity |
Integer |
Y |
- |
1 |
개별 상품 수량 |
| product_price |
decimal |
Y |
- |
1100, 0.99 |
거래 금액 |
| product_currency |
string(3) |
Y |
- |
KRW, USD |
해당 금액의 통화 |
| txn_time |
long |
Y |
- |
1644489139000 |
결제 시각(Unix Timestamp UTC+0) |
| inservice_item_id |
string(30) |
Y |
- |
cp7892 |
게임내 아이템ID |
Sample