결제 조회
- 인쇄
- PDF
결제 조회
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
결제 아이디로 결제 내역을 조회합니다.
요청
GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/purchase/{transactionID}
| 항목 | 타입 | 필수 여부 | 설명 | 비고 |
|---|---|---|---|---|
| projectId | String | O | GamePot SDK의 projectId | |
| transactionID | String | O | GamePot SDK의 결제 아이디 |
요청 헤더
| 헤더명 | 필수 여부 | 설명 |
|---|---|---|
| x-api-key | O | GamePot에서 발급하는 인증 키 |
| accept-language | X | 사용 언어 |
응답
| 필드명 | 타입 | 설명 |
|---|---|---|
| status | Int | 결과값 (1: 성공) |
| (result의) status | Int | 결제 결과값 (1: 성공) |
| exchange_price | Int | 결제 금액 (환율 적용) |
| project_id | String | GamePot SDK의 projectId |
| store_id | String | 스토어 아이디 (google,one,apple,galaxy) |
| payment_id | String | 결제 스토어 아이디 (google,tpay...) ㅣ일반적으로 store_id와 동일 |
| signature | String | 서명 |
| order_id | String | Order ID |
| currency | String | 통화 |
| userdata | String | 유저 정보 |
| price | Int | 결제 금액 |
| id | String | 결제 데이터의 Unique ID |
| unique_id | String | Unique ID |
| transaction_id | String | 스토어 결제 ID |
| createdAt | String | 생성일 |
| updatedAt | String | 갱신일 |
| request | String | 결제 요청값 |
| response | String | 결제 응답값 |
| (item_id의) status | String | (item_id의) 결과값 |
| type | String | 아이템 타입 (inapp) |
| name | String | 아이템 이름 |
| prices | String | 아이템 가격 |
| user_id | 응답 성공값 중 user_id 부분은 사용자 조회 API 참고 바람 |
예시
요청 예시
curl --request GET \
--url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/purchase/GPA.xxxx-xxxx-xxxx-xxxxxx \
--header 'accept-language: ko' \
--header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'
응답 예시
{
"status": 1,
"result": {
"status": 1,
"exchange_price": 5000,
"project_id": "xxxxxxxxxxxxxx",
"store_id": "google",
"payment_id": "google",
"signature": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"order_id": "u8934",
"currency": "KRW",
"userdata": "{\"unique_id\":\"u8934\",\"server_id\":\"\",\"player_id\":\"\",\"etc\":\"\"}",
"price": 5000,
"id": "xxxxxxxxxxxxxx",
"unique_id": "u8934",
"transaction_id": "xxxxxxxxxxxxxx",
"createdAt": "Wed Mar 18 2020 17:55:29 GMT+0900 (GMT+09:00)",
"updatedAt": "Wed Mar 18 2020 17:55:29 GMT+0900 (GMT+09:00)",
"request": "https://xxxxxxxxxxxxxx",
"response": "{\"status\":1}",
"item_id": {
"status": null,
"type": "inapp",
"name": "name_001",
"prices": []
},
"user_id": {
"id": "xxxxxxxxxxxxxx",
"deleted": false,
"store_id": "google",
"country": "KR",
"remoteip": "xxx.xxx.xxx.xxx",
"adid": "xxxxxxxxxxxxxx",
"device": "android",
"network": "WIFI",
"version": "10",
"model": "Pixel_3",
"token": "xxxxxxxxxxxxxx",
"push": true,
"night": false,
"ad": true,
"memo": null,
"device_id": "xxxxxxxxxxxxxx",
"createdAt": "Wed Mar 18 2020 17:54:41 GMT+0900 (GMT+09:00)",
"updatedAt": "Wed Mar 18 2020 17:54:42 GMT+0900 (GMT+09:00)",
"loginedAt": "Wed Mar 18 2020 17:54:41 GMT+0900 (GMT+09:00)",
"deletedAt": null
}
}
}
오류 코드
Gamepot Open API 요청시 발생하는 공통 에러코드입니다.
| 파라미터 | 설명 |
|---|---|
| status | 오류 코드(1: 성공, 실패시 Error code 참고) |
| message | 오류 상세 설명 |
| 오류 코드 | 설명 |
|---|---|
| -1 | 대시보드에 없는 키를 사용한 경우 |
| -2 | 대시보드의 키와 헤더의 키가 다른경우 |
| -3 | 대시보드에서 삭제한 키를 사용한 경우 |
| -4 | 대시보드에서 미사용으로 처리된 키를 사용한 경우 |
| -5 | 키가 만료된 경우 |
| -6 | 프로젝트 아이디가 없는 경우 |
{
"status": -6,
"message": "projectId was wrong."
}
이 문서가 도움이 되었습니까?