결제 조회

Prev Next

결제 아이디로 결제 내역을 조회합니다.

요청

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."
}