en zh

开始使用 Samsung IAP API

有两种 Samsung 应用程序内购买 (IAP) API,提供以下功能:

  • Orders - 查看特定日期的付款和退款
  • Publish - 查看、注册、修改和删除 IAP 项目

要开始使用 IAP API,必须满足特定的要求并使用下述规定的授权头参数。

要求

要使用 IAP APIs,需要满足以下条件:

  • IAP APIs 属于 Galaxy Store 开发者 API 的一部分。您必须满足 Galaxy Store 开发者 API 的所有要求,包括但不限于创建访问令牌、在每个 IAP 发布 API 调用的授权标头中包括访问令牌,以及取得商业卖家身份,以便管理应用程序内购买项目。

  • IAP APIs 必须与卖家门户的“应用程序内购买”选项卡区域中的内容之间建立连接。要创建此连接,您必须先使用内容发布 API分发内容,或者内容必须在卖家门户中处于 For Sale 状态。如果此连接不存在,则无法检索匹配的产品信息。

  • 您必须将 IAP SDK 集成到您的应用程序中。在您的内容中注册的所有二进制文件必须支持 IAP。

如果不满足这些要求,将返回错误代码 106。

授权参数

每个请求都必须包括授权标头参数,用于指定内容类型、您的访问令牌和服务帐户 ID,并且 URL 路径必须包含程序包名称。有关如何创建访问令牌和服务帐户 ID 的详细信息,请参阅创建访问令牌

属性 范围 说明
Authorization 标头 必需。使用 Bearer <your-access-token>,其中 <your-access-token> 是您从 Galaxy Store 身份验证服务器请求的访问令牌

service-account-id 标头 必需。服务帐户 ID,用于创建与访问令牌关联的 JWT(可以在卖家门户的“帮助”>“API 服务”区域中找到)

content-type 标头 必需。必需为 application/json

packageName 路径 必需。应用程序的程序包名称

以下示例显示了与 IAP APIs 结合使用的标头:

curl -X IAP_PUBLISH_API_REQUEST \
  -H  "content-type: application/json" \
  -H  "Authorization: Bearer <your-access-token>" \
  -H  "service-account-id: <your-service-account-id>"