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}&tp={tp}

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