consumePurchase API

本文档主要关注用于服务器端购买消费的 consumePurchase API。

您验证购买后，应将其标记为已消费。

购买的消费包含：

将购买的产品分配给用户。
通知now.gg产品已被消费。

重要信息

此API须从您应用的后端服务器调用。

基础URL（Base URL）

 https://payments-api.now.gg/

请求路径（Request Path）

 v2/order/consumePurchase

请求方法（Request Method）

 POST

请求头（Request Header）

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

请求主体（Request Body）

以下参数须包含于 consumePurchase API的请求主体中。

 "purchaseToken": "<purchase_token_here>",
  "productId": "<product_id_here>", // 已弃用
  "developerPayload" : "developerPayload", // 可选
  "type": "<store>"  // 已弃用

重要信息

productId 和 type 字段已弃用。
Amazon和Huawei商店不支持服务器端消费。请参考客户端消费:
- 原生Android
- Unity

消费购买的示例代码

以下示例代码演示了使用 consumePurchase API的关联请求。

import requests

 url = "https://payments-api.now.gg/v2/order/consumePurchase"

 headers = {
     "Authorization": "<payment_api_key_here>",
     "Content-Type": "application/x-www-form-urlencoded"
 }

 data = {
     "purchaseToken": "<purchase_token_here>",
     "developerPayload": "developerPayload"  // 可选 
 }

 response = requests.post(url, headers=headers, data=data)

 print("响应状态码:", response.status_code)
 print("响应正文:", response.text)

curl --location --request POST 'https://payments-api.now.gg/v2/order/consumePurchase' \
 --header 'Authorization: <payment_api_key_here>' \
 --header 'Content-Type': 'application/x-www-form-urlencoded' \
 --data '{
     "purchaseToken": "<purchase_token_here>",
     "developerPayload" : "developerPayload" // 可选
 }'

重要信息

API秘钥（API Key） – Payments API Key 可以在nowStudio的证书章节找到。更多信息。
购买令牌（purchaseToken）在成功购买后返回。您可以查看下列参考文档以获得更多信息：
- PurchasesUpdatedListener 和 Purchase（原生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秘钥无效。
3901	INVALID_PURCHASE_TOKEN	提供的购买令牌无效。
5014	MULTISTORE_UNKNOWN_ERROR	表示来自Multistore API的通用错误。
5015	MULTISTORE_AUTH_ERROR	表示在生成Multistore API的认证/凭据时发生错误。