consumePurchase API

このセクションには、consumePurchaseのAPI リファレンスとサンプルリクエスト・コードセグメントが含まれます。

購入を確認したら消費済みとして処理してください。

消費購入には以下が含まれます。:

購入した製品をユーザに割り当てます。
商品が消費されたことをnow.ggに通知します。

重要な情報

このAPIはアプリのバックエンドサーバーから呼び出す必要があります。

基本URL

 https://cloud-api.bluestacks.cn/

リクエストパス

 v2/order/consumePurchase

リクエストメソッド

 POST

リクエストヘッダー

 'Authorization': '<payment_api_key_here>',
  'Content-Type': 'application/x-www-form-urlencoded'

リクエストボディ

consumePurchase APIのリクエストボディには、次のパラメータを含める必要があります:

 
   purchaseToken=<nowgg_purchase_token>

消費購入コードのサンプル

以下のサンプルコードはconsumePurchase API を使用した関連リクエストの例です。

import requests

  url = "https://cloud-api.bluestacks.cn/v2/order/consumePurchase"

  payload = 'purchaseToken=nowgg-_purchase_token'
  headers = {
    'Authorization': 'payment_api_key_here',
    'Content-Type': 'application/x-www-form-urlencoded'
  }

  response = requests.request("POST", url, headers=headers, data=payload)

  print(response.text)

重要な情報

API Key – Payments API Key はnowStudioのクレデンシャルセクションで確認することができます。詳細はこちら
購入が成功すると、PurchaseTokenが返されます。詳細については、以下の参考ドキュメントを参照してください：
- PurchasesUpdatedListener と購入 (Android アプリ)
- PurchasedProduct (Unity)

期待されるレスポンス

以下はconsumePurchase APIからのレスポンスのサンプルです。

 {  
   "success": true,
   "code": 0,
   "codeMsg": "success",
   "data": {}
 }

レスポンスパラメータ

パラメータ	型	説明
success	boolean	処理結果をtrueまたはfalseで返します。
code	int	成功した場合は 0、失敗した場合は 0 以外のコードを返します。
codeMsg	string	エラーコードに関連するメッセージを返します。
data	object	デコードされたデータがレスポンスとして返されます。

エラーコードマッピング

エラーコード	メッセージ	説明
3800	ERROR_CONSUMING_PRODUCT	製品の消費処理中にエラーが発生しました。
3900	INVALID_AUTHORIZATION_KEY	認証のために渡されたAPI Keyが無効です。
3901	INVALID_PURCHASE_TOKEN	渡された購入トークンが無効です。