決済 照会

Prev Next

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

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