NAVERクラウドプラットフォーム商品の使用方法をより詳細に提供し、様々なAPIの活用をサポートするために[説明書]と[APIリファレンス]を分けて提供しています。

GAMEPOT APIリファレンスへ >>
GAMEPOT説明書へ >>

Server API

GAMEPOTサーバ > ゲームサーバ

Purchase Webhook(required)

決済が完了すると、GAMEPOTサーバからゲームサーバにアイテム支給のためのHTTPリクエストを行います。

GAMEPOTは、ユーザーから伝達された決済情報をもとにストア領収証の検証まで行って不正決済を防いでいます。

Request

HTTPリクエストの際に以下のような内容の情報を伝えます。その情報をもとにユーザーにアイテムを支給してください。

{domain}項目は開発会社で操作を完了してから知らせてください。この値はGAMEPOTダッシュボード - プロジェクトの設定 - 一般 - Webhook項目に追加する必要があります。

https://{domain}?
userId={uuid}&orderId={orderId}&projectId={projectId}&platform={platform}&productId={productId}&store={store}&payment={payment}&transactionId={transactionId}&gamepotOrderId={gamepotOrderId}&uniqueId={uniqueId}

Response

レスポンスは以下のような形式で行ってください。

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

Item Webhook(required)

クーポンを使用すると、GAMEPOTサーバからゲームサーバにアイテム支給のためのHTTPリクエストを行います。

Request

HTTPリクエストの際に以下のような内容の情報を伝えます。その情報をもとにユーザーにアイテムを支給してください。

{domain}項目は開発会社で操作を完了してから知らせてください。この値はGAMEPOTダッシュボード - プロジェクトの設定 - 一般 - Webhook項目に追加する必要があります。

https://{domain}?
userId={userId}&projectId={projectId}&platform={platform}&store={store}&userData={userData}&itemId=[{itemData}, {itemData}, ...]

ex)

https://{domain}?itemId=[{"item_id":"d0781c4e-df52-465b-ab93-0ee16fbf445d","store_item_id":"ttt","count":1}]&platform=android&projectId=f1df9464-40a8-4a66-8421-196c7c661002&store=google&userId=2d485044-06c2-48c4-a6ed-4ab53dea88bb

Response

レスポンスは以下のような形式で行ってください。

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

ゲームサーバ > GAMEPOTサーバ

Token Authentication(optional)

ゲームログイン完了後に取得した情報を用いて、GAMEPOTサーバでログイン検証ができます。

トークン検証は2段階で行われ、第1段階のGAMEPOTトークン検証の後、第2段階のソーシャルトークン検証が行われます。

第2段階の検証ではGAMEPOTダッシュボード - プロジェクトの設定 - Auth keyに値を入力する必要があります。

第1段階のGAMEPOTトークン検証では、ログイン後に取得したMemberID(ユーザーID)、Tokenで同期トークン検証を行い、

第2段階のソーシャルトークン検証では、GoogleログインやFacebookログイン時に取得したソーシャルアカウントのトークンでソーシャル非同期トークン検証を行います。

第2段階で検証に失敗した場合はGAMEPOTの利用停止機能が作動し、その後再ログインはできません。

検証失敗による利用停止は、GAMEPOTダッシュボード - プロジェクトの設定 - Auth key項目でスイッチがONになっている場合にのみ作動し、利用停止対象者はGAMEPOTダッシュボード - 会員 - 利用停止メニューで確認できます。

第1段階の検証を同期処理しないでください!

ユーザーがログインするプロセスですが、この機能を同期処理するとネットワーク通信による遅延が発生してゲーム利用の妨げになります。また、当該ネットワーク通信が物理的に分離されている状況なので、それによってネットワーク通信が不安定になる場合が多々あります。

この機能は非同期処理し、その後にゲーム利用を制限する形で機能を実装してください。

Request

データ完全性のために、ゲームクライアントではなく開発会社のサーバで行ってください。

POST
url : https://gamepot.apigw.ntruss.com/gpapps/v1/loginauth
Header : 'content-type: application/json'
data:
{
    「projectId」：{GamePot SDKのprojectId}、
    「memberId」：{GamePot SDKのmemberid(メンバーID)}、
    「token」：{GamePot SDKのToken}
}

Response

第1段階検証で検証に失敗した場合、statusに1ではない値が入力されます。

この場合はゲーム入場を制限してください。

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

Error code

ThirdParty Purchase

この機能は一般的には使用されない機能なので、適用前にGAMEPOTまでお問い合わせください。

Request

POST
url : https://gamepot.apigw.ntruss.com/gpapps/v2/thirdparty/purchase
Header : 'content-type: application/json'
Header : 'x-api-key: xxxxxxxxxxx'
data:
{
    "projectId": "e948e5bc-dccd-4729-b9b0-b547ae34b85d",
    "store": "tpay",
    "productId": "purchase_001",
    "transactionId": "t-123412812-sadl-2384-75847",
    "memberId":"89a907ed-0e1d-42fb-ae4d-75e95581220d",
    "currency": "KRW",
    "price":1000,
    "paymentId": "prepaid",
    "uniqueId": ""
}

Response

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

Error code