管理订阅

每个应用程序内项目都会分配一个唯一的项目或产品 ID。购买项目之前或之后，您的应用程序可以使用此产品 ID 请求关于订阅项目的应用程序相关详细信息。

如果应用程序内项目购买和付款交易成功，Samsung IAP 将会为该项目分配一个唯一的购买 ID。您的应用程序服务器使用此购买 ID 获取关于订阅的应用程序或用户相关详细信息。

可以在购买项目之前或之后请求应用程序相关详细信息，这些信息包括您为卖家门户中的项目配置的信息（例如订阅期限长度、定价选项、适用期限和价格）。

可以在购买项目之后请求与用户相关的详细信息，这些信息包括有关用户订阅的当前详细信息（例如订阅状态、当前支付价格和续订次数）。

如果您的应用程序未收到购买 ID（例如，由于网络问题），则可以使用 getOwnedList() 来请求该信息。

以下 API 调用用于管理您的订阅项目（单击 API 调用可查看更多详细信息）：

getOwnedList()（IAP SDK API）– 获取当前处于免费试用期或有效订阅期限内的用户拥有的项目列表。响应内容为一个对象数组 (OwnedProductVo)。应用程序可以通过引用 onGetOwnedProducts() 数据来检查订阅项目的可用性。购买项目后，此 API 提供有意义的信息。当启动应用程序以确定用户是否已成功订阅或自动续订项目时，可以使用此调用。有效的订阅期限结束之前，响应中将包括已取消的订阅项目。

与订阅相关的对象包括产品 ID、购买 ID、当前价格、购买日期和当前订阅期限结束日期。
getProductsDetails()（IAP SDK API）– 获取有关在卖家门户中配置的订阅项目的详细信息。此调用需要订阅项目的产品 ID。响应内容为一个对象数组 (ProductVo)。可以在购买项目之前或之后调用此 API。

与订阅相关的对象包括当前价格、订阅期限长度、订阅定价选项、适用期限、免费试用期的持续时间。
iap/v6/receipt（IAP 服务器 API）– 验证订阅购买和付款交易是否已成功完成。此调用需要订阅项目的购买 ID。相关信息将在 SOAP 响应中返回。可以在购买项目之前或之后调用此 API。

与订阅相关的内容包括订阅标识符、付款交易标识符、购买收据标识符、订阅的名称、订阅的说明、购买和付款交易的日期及时间、已计费的总金额（包括订阅价格和所有适用的税款）以及付款交易状态。
getSubscriptionStatus（IAP 服务器 API）– 获取订阅状态、项目信息和购买信息，用于验证是否已成功购买项目。此调用需要订阅项目的购买 ID 和用于进行身份验证的服务令牌，将在卖家的后端服务器上检查用户的订阅信息。相关信息将在 SOAP 响应中返回。购买项目后，此 API 提供有意义的信息。

与订阅相关的内容包括购买日期、当前订阅状态、当前价格、当前订阅定价选项、续订次数、付费订阅开始日期、订阅结束日期以及取消原因。

有关这些及其他 API 调用的更多详细信息，请参阅《Samsung IAP 编程指南》。

通过电子邮件发送收据

Samsung IAP 将向订阅项目购买者发送有关重要事件的电子邮件：

免费试用注册电子邮件：初次购买免费试用的项目之后发送。包含项目产品和订单信息。
订阅购买电子邮件：初次购买非免费试用的项目之后、续订订阅时以及再次购买项目之后发送。包含项目产品和付款信息，包括为项目的第一个使用期限支付的价格（例如，免费试用 ($0)、低层价格或常规层价格）。
免费试用过期电子邮件：免费试用期结束前 7 天发送。包含项目产品和订阅信息。
订阅续订电子邮件：每个低层或常规订阅期限即将结束时发送，指示即将对下一个订阅期限自动付款。包含项目产品和订阅信息。
订阅取消电子邮件：取消项目之后发送，无论是由用户还是出于其他原因取消。包含项目产品信息。

注册订阅项目

请参阅《IAP 编程指南》中的“在卖家门户中注册应用程序和应用程序内项目”，了解详细信息。

测试订阅

请参阅《IAP 测试指南》中的“测试订阅项目”，了解详细信息。