---
title: "決済 照会"
slug: "game-gamepot-purchase"
updated: 2026-09-17T09:57:53Z
published: 2026-09-17T09:57:53Z
canonical: "api.ncloud-docs.com/game-gamepot-purchase"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 決済 照会

**当該コンテンツは、ローカリゼーションサービスを準備しております。早急にローカライズサービスをご提供できるよう、努めております。**

決済IDで決済内訳を照会します。

## 要請

```
GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/purchase/{transactionID}
```

| 項目 | タイプ | 必須かどうか | 説明 | 備考 |
| --- | --- | --- | --- | --- |
| projectId | String | O | GamePot SDKの projectId |  |
| transactionID | String | O | GamePot SDKの 決済ID |  |

### 要請Header

| Header名 | 必須かどうか | 説明 |
| --- | --- | --- |
| x-api-key | O | GamePotで発行する認証key |
| accept-language | X | 使用言語 |

## 応答

| フィールド名 | タイプ | 説明 |
| --- | --- | --- |
| status | Int | 結果値 (1: 成功) |
| (result의) status | Int | 決済結果値 (1: 成功) |
| exchange_price | Int | 決済金額 (환율 적용) |
| project_id | String | GamePot SDKの projectId |
| store_id | String | ストア ID (google,one,apple,galaxy) |
| payment_id | String | 決済 ストア ID (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リクエスト時に発生する共通エラーコードです。

| parameter | 説明 |
| --- | --- |
| status | エラーコード(1: 成功、失敗時Error code参考) |
| message | エラー詳細説明 |

| エラーコード | 説明 |
| --- | --- |
| -1 | ダッシュボードにないkeyを使用した場合 |
| -2 | ダッシュボードのkeyとheaderのkeyが異なる場合 |
| -3 | ダッシュボードで削除したkeyを使用した場合 |
| -4 | ダッシュボードで未使用に処理されたkeyを使用した場合 |
| -5 | keyが切れた場合 |
| -6 | プロジェクトIDがない場合 |

```
{
  "status": -6,
  "message": "projectId was wrong."
}
```