---
title: "クーポンの使用"
slug: "game-gamepot-storeusercoupon"
updated: 2026-09-17T09:57:53Z
published: 2026-09-17T09:57:53Z
canonical: "api.ncloud-docs.com/game-gamepot-storeusercoupon"
---

> ## 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.

# クーポンの使用

一般のクーポン、キーワードクーポンを使用できます。

## リクエスト

```
PUT https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/store/{storeID}/user/{userID}/coupon/{couponNumber}?userData={userData}
```

| 項目 | タイプ | 必須 | 説明 | 備考 |
| --- | --- | --- | --- | --- |
| projectId | String | O | GAMEPOT SDKの projectId |  |
| storeID | String | O | ストア ID(google、one、apple、galaxy) |  |
| userID | String | O | GAMEPOT SDKのユーザー UID |  |
| couponNumber | String | O | ダッシュボードで発行されたクーポン番号 |  |
| userData | String | X | Webフック APIパラメータのうち userData項目に入れる追加情報 |  |

### リクエストヘッダ

| ヘッダ名 | 必須 | 説明 |
| --- | --- | --- |
| x-api-key | O | GAMEPOTで発行する認証キー |
| accept-language | X | 使用言語 |

## レスポンス

| フィールド名 | タイプ | 説明 |
| --- | --- | --- |
| status | Int | 結果値 (1: 成功) |
| message | String | 結果の内容 |

## 例

### リクエスト例

```
  curl --request PUT \
  --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/store/google/user/h43ea8e8-xxxx-xxxx-xxxx-531a46d25eef/coupon/xxxxxx \
  --header 'accept-language: ko' \
  --header 'x-api-key: 86dcgffae064174543xxxx02a8801ce5a547xxxxxxxxxxxxxx'
```

### レスポンス例

```
{
  "status": 1,
  "message": "success"
}
```

## エラーコード

Gamepot Open APIをリクエストする際に発生する共通エラーコードです。

| パラメータ | 説明 |
| --- | --- |
| status | エラーコード (1: 成功、失敗時は Error code参照) |
| message | エラー詳細の説明 |

| エラーコード | 説明 |
| --- | --- |
| -1 | ダッシュボードにないキーを使用した場合 |
| -2 | ダッシュボードのキーとヘッダのキーが別の場合 |
| -3 | ダッシュボードで削除したキーを使用した場合 |
| -4 | ダッシュボードで未使用として処理されたキーを使用した場合 |
| -5 | キーの期限が切れた場合 |
| -6 | プロジェクト IDがない場合 |
| -100 | 処理中にエラーが発生した場合 |

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