智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
全部文档
指南
API
开放能力API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
PurchaseOrderPayload
购买数据模型，支持消耗型商品、非消耗型商品、自动续期订阅商品和非续期订阅商品。
展开
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| environment | 是 | String | 环境类型。 - NORMAL：生产环境 - SANDBOX：沙盒环境 |
| purchaseOrderId | 是 | String | 具体一笔订单中对应的购买订单号ID。最大长度256。 |
| purchaseToken | 是 | String | 购买token，在购买消耗型/非消耗型/非续期订阅商品场景中与具体购买订单一一对应，在自动续期订阅商品场景中与订阅ID一一对应。一个购买令牌（purchaseToken）只能发货一次，对购买令牌（purchaseToken）需要进行发货次数限制，否则可能会导致某些场景下向用户多次发货，造成损失。最大长度256。 |
| applicationId | 是 | String | 应用ID，获取方式参见配置应用身份信息。 |
| productId | 是 | String | 商品ID。 |
| productType | 是 | String | 商品类型。具体取值如下： 0：消耗型商品 1：非消耗型商品 2：自动续期订阅商品 3：非续期订阅商品 |
| quantity | 否 | Long | 购买的商品数量。仅适用于消耗型商品和非续期订阅型商品的批量购买场景。 一次请求数量不超过10个。 说明： 如果开发者使用了quantity参数以支持商品的批量购买，则需要在发货时校验下单的商品数量和最终发货商品数量是否一致，避免造成漏发、多发的情况。 元服务API： 从版本5.0.3(15)开始，该接口支持在元服务中使用。 起始版本： 5.0.3(15) |
| purchaseTime | 是 | Long | 购买时间，UTC时间戳，以毫秒为单位。 如果没有完成购买，则没有值。 |
| finishStatus | 否 | String | 发货状态。具体取值如下： 1：已发货 2：未发货 |
| needFinish | 否 | Boolean | 是否需要确认发货，完成购买。具体取值如下： - true：必须确认发货，完成购买 - false：可选确认发货，完成购买 |
| price | 是 | Long | 价格，单位：分。 |
| currency | 是 | String | 币种，请参见ISO 4217标准。例如CNY、USD、MYR。 |
| developerPayload | 否 | String | 商户侧保留信息，由开发者在调用支付接口时传入。 |
| purchaseOrderRevocationReasonCode | 否 | String | 购买订单撤销原因。 0：其他 1：用户遇到问题退款 |
| revocationTime | 否 | Long | 购买订单撤销时间，UTC时间戳，以毫秒为单位。 |
| offerTypeCode | 否 | String | 优惠类型。 消耗型/非消耗型/非续期订阅商品: 1：优惠促销 自动续期订阅商品： 1：推介促销 2：优惠促销 4：挽留促销 |
| offerId | 否 | String | 优惠ID。 |
| countryCode | 是 | String | 国家/地区码，用于区分国家/地区信息，请参见ISO 3166标准。 |
| signedTime | 是 | Long | 签名时间，UTC时间戳，以毫秒为单位。 |
以下参数只在自动续期订阅商品场景返回：
展开
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| subGroupGenerationId | 是 | String | 订阅组的代ID。 - 用户切换订阅商品时，此ID不会改变。 - 订阅失效且超出保留期后，用户重新购买商品时，此ID会改变。 |
| subscriptionId | 是 | String | 商品的订阅ID。以下场景，此ID会发生改变： - 用户切换订阅商品时。 - 订阅失效且超出保留期后，用户重新购买商品时。 |
| subGroupId | 是 | String | 订阅型商品所属的商品组ID。 |
| duration | 是 | String | 此次购买的有效周期，采用ISO 8601格式。例如：P1W表示一周，P1M表示一个月。 |
| durationTypeCode | 是 | String | 订阅周期段类型。 0：正常周期段 1：延期段 |
PurchaseReservedInfo
购买优惠策略扩展信息。
展开
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| productItem | 是 | ProductItem | 购买商品信息。 |
| offerInfo | 是 | OfferInfo | 优惠策略参数。 |
ProductItem
购买商品信息。
展开
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| applicationId | 是 | String | 应用ID，获取方式参见配置应用身份信息。 |
| productId | 是 | String | 商品ID。 |
OfferInfo
优惠策略参数。
展开
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| offerId | 是 | String | 优惠ID。优惠ID来源于开发者在AppGallery Connect中配置商品信息时设置优惠促销信息，配置的优惠ID，具体请参见设置促销价格。 |
| applicationUserName | 否 | String | 用户账户相关联的混淆字符串，唯一标识用户，传递优惠ID场景，可以传递该字段，若传递了本字段则需在PurchaseParameter请求参数中传递一个相同的applicationUserName。 |
| nonce | 是 | String | 唯一的UUID，由开发者生成，全小写，需要保证系统内全局唯一。 |
华为开发者联盟 版权所有 ©2026
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词