IAP

has.queryIapEnvStatus

has.queryIapEnvStatus(Object object)

查询用户登录的账号服务地是否在IAP Kit支持结算的国家/地区中。当前只支持中国大陆。

需要权限： 开发前需要配置Client ID、配置签名证书指纹、开通商户服务、开启和激活应用内购买服务。

起始版本： 1.0.5

参数：

参数为Object对象，包括以下字段。

错误码信息：

错误码：

示例：

has.queryIapEnvStatus({
  success: () => {
    console.info('queryIapEnvStatus success');
  },
  fail: (err) => {
    console.error('queryIapEnvStatus fail', err);
  },
  complete: (res) => {
    console.info('queryIapEnvStatus complete', res);
  }
});

has.createIap

has.createIap(Object object)

发起购买，支持消耗型商品、非消耗型商品和自动续期订阅商品。在HarmonyOS 开发者中心创建商品后，使用此接口拉起华为应用内支付收银台，显示商品名称、价格等信息。

需要权限： 开发前需要配置Client ID、配置签名证书指纹、开通商户服务、开启和激活应用内购买服务。

起始版本： 1.0.5

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码信息：

示例：

has.createIap({
  // 替换为实际的商品id
  productId: 'product_id',
  productType: 0,
  developerPayload: '',
  reservedInfo: JSON.stringify({ key1: 'value1' }),
  promotionalOfferId: '',
  applicationUserName: '',
  jwsRepresentation: '',
  success: (res) => {
    console.info('createIap success', res);
  },
  fail: (err) => {
    console.error('createIap fail', err);
  },
  complete: (res) => {
    console.info('createIap complete', res);
  }
});

has.finishIap

has.finishIap(Object object)

应用完成已购商品的发货后，调用此接口确认发货，指明此次购买流程结束。

需要权限： 开发前需要配置Client ID、配置签名证书指纹、开通商户服务、开启和激活应用内购买服务。

起始版本： 1.0.5

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

has.finishIap({
  productType: 0,
  // 替换为实际的purchaseToken
  purchaseToken: '***',
  // 替换为实际的purchaseOrderId
  purchaseOrderId: '***',
  success: () => {
    console.info('finishIap success');
  },
  fail: (err) => {
    console.error('finishIap fail', err);
  },
  complete: (res) => {
    console.info('finishIap complete', res);
  }
});

has.queryIap

has.queryIap(Object object)

查询用户已订购商品的购买数据，包括消耗型商品和非消耗型商品，一次请求只能查询一种类型的商品。

• 若查询消耗型商品，IAP仅返回用户已购未消耗的购买数据。若有购买数据返回，说明可能存在因某些异常而导致未进行发货的情况，需要应用判断是否已发货，未发货则需要进行补发货处理。

• 若查询非消耗型商品，IAP返回用户所有已订购商品的购买数据。

需要权限： 开发前需要配置Client ID、配置签名证书指纹、开通商户服务、开启和激活应用内购买服务。

起始版本： 1.0.5

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码信息：

示例：

has.queryIap({
  productType: 0,
  queryType: 1,
  success: (res) => {
    console.info('queryIap success', res);
  },
  fail: (err) => {
    console.error('queryIap fail', err);
  },
  complete: (res) => {
    console.info('queryIap complete', res);
  }
});

has.queryIapProducts

has.queryIapProducts(Object object)

获取在HarmonyOS 开发者中心上配置的商品的详情信息。

需要权限： 开发前需要配置Client ID、配置签名证书指纹、开通商户服务、开启和激活应用内购买服务。

起始版本： 1.0.10

参数：

参数为Object对象，包括以下字段。

success返回值：

返回Product数组。

错误码信息：

示例：

has.queryIapProducts({
  productType: 0,
  productIds: ['xxx-1', 'xxx-2'],
  success: (res) => {
    console.info('queryIapProducts success', res);
  },
  fail: (err) => {
    console.error('queryIapProducts fail', err);
  },
  complete: (res) => {
    console.info('queryIapProducts complete', res);
  }
});

has.isIapSandboxActivated

has.isIapSandboxActivated(Object object)

检查沙盒测试能力是否生效。

需要权限： 开发前需要配置Client ID、配置签名证书指纹、开通商户服务、开启和激活应用内购买服务。

起始版本： 1.0.10

参数：

参数为Object对象，包括以下字段。

success返回值：

返回boolean，代表沙盒测试能力是否生效。

错误码信息：

示例：

has.isIapSandboxActivated({
  success: (res) => {
    console.info('isIapSandboxActivated success', res);
  },
  fail: (err) => {
    console.error('isIapSandboxActivated fail', err);
  },
  complete: (res) => {
    console.info('isIapSandboxActivated complete', res);
  }
});

has.showIapManagedSubscriptions

has.showIapManagedSubscriptions(Object object)

跳转到订阅页或订阅详情页。

需要权限： 开发前需要配置Client ID、配置签名证书指纹、开通商户服务、开启和激活应用内购买服务。

起始版本： 1.0.10

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

has.showIapManagedSubscriptions({
  uiParameter: {
    windowScreenMode: 1
  },
  groupId: 'xxx',
  success: () => {
    console.info('showIapManagedSubscriptions success');
  },
  fail: (err) => {
    console.error('showIapManagedSubscriptions fail', err);
  },
  complete: (res) => {
    console.info('showIapManagedSubscriptions complete', res);
  }
});

PurchaseData

包含jws格式的订单信息、订阅状态信息。

起始版本： 1.0.5

PurchaseOrderPayload

订单信息模型，支持消耗型商品、非消耗型商品和自动续期订阅商品。

起始版本： 1.0.5

SubGroupStatusPayload

订阅组相关的订阅状态信息。

起始版本： 1.0.5

SubscriptionStatus

订阅状态信息。

起始版本： 1.0.5

SubRenewalInfo

订阅的扣费计划信息。

起始版本： 1.0.5

UIWindowParameter

界面窗口参数。

起始版本： 1.0.10

Product

包含单个商品详细信息。

起始版本： 1.0.10

SubscriptionInfo

订阅信息。

起始版本： 1.0.10

SubscriptionOffer

促销信息。

起始版本： 1.0.10

PromotionalOffer

订阅商品支持的自定义优惠信息。

起始版本： 1.0.10