文档管理中心

此版本文档已归档不再维护,推荐您使用最新版本

API参考应用内支付服务手机、平板客户端API参考iap.entityInAppPurchaseData

InAppPurchaseData

CLASS info
public class InAppPurchaseData extends java.lang.Object
用于解析 InAppPurchaseData String的工具类。

Nested Class Summary

TypeNameDesc
static interfaceInAppPurchaseData.PurchaseState可能的订单状态。

Field Summary

TypeNameDesc
static intNOT_PRESENT指示该字段在源json string中不存在。

Public Constructor Summary

Constructor name

InAppPurchaseData(java.lang.String iapData)

利用InAppPurchaseData String构造一个InAppPurchaseData类。

Public Method Summary

Return typeMethod name
java.lang.StringgetAppInfo()
App信息,预留。
longgetApplicationId()
应用ID。
intgetCancelledSubKeepDays()
用户取消后订阅关系保留的天数。
intgetCancelReason()
取消原因
longgetCancelTime()
取消时间的时间戳
java.lang.StringgetCountry()
国家码
java.lang.StringgetCurrency()
币种
longgetDaysLasted()
已经付费订阅的天数,免费试用和促销期周期除外。
java.lang.StringgetDeveloperPayload()
开发者提供的内容
longgetExpirationDate()
订阅商品过期时间的时间戳。
intgetExpirationIntent()
过期原因
IntgetIntroductoryFlag()
是否处于促销价续期周期内。
java.lang.StringgetLastOrderId()
上次续期收款的订单ID,由支付服务器在续期扣费时生成。
intgetNotifyClosed()
用户是否已经关闭订阅上的通知
longgetNumOfDiscount()
成功促销续期期数
longgetNumOfPeriods()
成功标准续期(没有设置促销的续期)的期数
java.lang.StringgetOrderID()
订单id
longgetOriPurchaseTime()
原购买时间的时间戳,即本订阅商品首次成功收费时间距离1970年1月1日0点的毫秒数
java.lang.StringgetPackageName()
应用安装包名
longgetPrice()
商品实际价格*100以后的值
intgetPriceConsentStatus()
商品提价时的用户意见
java.lang.StringgetProductGroup()
订阅商品所属的订阅组ID
java.lang.StringgetProductId()
商品ID
java.lang.StringgetProductName()
商品名称
intgetPurchaseState()
订单交易状态
longgetPurchaseTime()
商品购买时间的时间戳,即自1970年1月1日0时起到商品购买时间的毫秒数
java.lang.StringgetPurchaseToken()
用于唯一标识商品和用户对应关系的购买令牌,在支付完成时由华为支付服务器生成
intgetPurchaseType()
购买类型
intgetQuantity()
购买数量
longgetRenewPrice()
续期价格
intgetRenewStatus()
续期状态
intgetRetryFlag()
一个过期的订阅,系统是否仍然在尝试自动完成续期处理
java.lang.StringgetSubscriptionId()
订阅ID。
intgetTrialFlag()
是否处于免费试用周期内
booleanisAutoRenewing()
续期状态
booleanisSubValid()
为true表示商品已经收费且未过期,也没有发生退款,开发者可以基于该标志为用户提供服务。
为false表示未完成购买或者已经过期,或者购买后已经退款。
intgetCancelledSubKeepDays()
用户取消后订阅关系保留的天数,并不表示本订阅已经取消。
int

getKind()

应用内支付商品类型。

java.lang.StringgetDeveloperChallenge()

消耗订单时开发者提供的挑战字符串。

int

getConsumptionState()

订单消耗状态。

java.lang.String

getPayOrderId()

支付订单ID。

java.lang.StringgetPayType()

支付方式类型。

int

getDeferFlag()

订阅费延期标志。

java.lang.String
getOriSubscriptionId()

原始订阅ID。

int

getCancelWay()

订阅取消来源。

longgetCancellationTime()

订阅取消时间戳。

longgetResumeTime()
订阅商品暂停订阅后的恢复时间。
int

getAccountFlag()

获取帐号类型。

Constants

Constant
public static final int NOT_PRESENT
指示该字段不在源 json string中。

Public Constructors

constructor
public InAppPurchaseData(java.lang.String iapData) throws org.json.JSONException
从 InAppPurchaseData String构造 InAppPurchaseData。

Parameters

Parameter nameParameter desc
iapData含有用户订单信息的String。


Throws

Parameter nameParameter desc
org.json.JSONException无法从json string中解析必选字段时。

Public Methods

Method
public long getApplicationId()
应用ID。
Method
public boolean isAutoRenewing()
消耗商品或者非消耗商品:固定为false。
订阅商品:
● true:订阅处于活动状态并且将在下一个结算日期自动续订。
● false:用户已经取消订阅。用户可以在下一个结算日期之前访问订阅内容,并且在该日期后将无法访问,除非他们重新启用自动续订。如果提供了宽限期,只要宽限期未过,此值就会对所有订阅保持设置为true。下一次结算日期每天都会自动延长,直至宽限期结束,或者用户更改他们的付款方式。
Method
public java.lang.String getOrderID()
华为支付服务器侧的订单ID,唯一标识一次交易,由华为支付服务器在支付时生成。
Method
public java.lang.String getPackageName()
应用安装包名。
Method
public java.lang.String getProductId()
商品ID。每种商品必须有唯一的ID,由应用在PMS中维护,或者应用发起购买时传入。
Method
public java.lang.String getProductName()
商品名称。
Method
public long getPurchaseTime()
商品购买时间的时间戳,即自1970年1月1日0时起到商品购买时间的毫秒数。
Method
public int getPurchaseState()
订单交易状态。
Method
public java.lang.String getDeveloperPayload()
商户侧保留信息,由开发者在调用支付接口时传入。
Method
public java.lang.String getPurchaseToken()

用于唯一标识商品和用户对应关系的购买令牌,在支付完成时由华为支付服务器生成。

说明:
  • 该字段是唯一标识商品和用户对应关系的,在订阅商品正常续订时不会改变。

  • 当前92位,后续存在扩展可能,如要进行存储,建议您预留128位的长度。

Method
public int getPurchaseType()
购买类型。
● 0:沙盒环境。
● 1:促销,暂不支持。
正式购买不会返回该参数。
Method
public java.lang.String getCurrency()
定价货币的币种。
Method
public long getPrice()
商品实际价格*100以后的值。商品实际价格精确到小数点后2位。
Method
public java.lang.String getCountry()
国家码,用于区分国家信息。
Method
public java.lang.String getLastOrderId()
上次续期收款的订单ID,由支付服务器在续期扣费时生成。
Method
public java.lang.String getProductGroup()
订阅商品所属的订阅组ID。
Method
public long getOriPurchaseTime()
原购买时间的时间戳,即本订阅商品首次成功收费时间距离1970年1月1日0点的毫秒数。
Method
public java.lang.String getSubscriptionId()
订阅ID。
Method
public int getQuantity()
购买数量。
Method
public long getDaysLasted()
已经付费订阅的天数,免费试用和促销期周期除外。
Method
public long getNumOfPeriods()
成功标准续期(没有设置促销的续期)的期数,为0或者不存在表示还没有成功续期。
Method
public long getNumOfDiscount()
成功促销续期期数。
Method
public long getExpirationDate()
订阅商品过期时间的时间戳。
对于一个成功收费的自动续订收据,该时间表示续期日期或者超期日期。如果商品最近的收据的该时间是一个过去的时间,则订阅已经过期。
Method
public int getExpirationIntent()

对于已经过期的订阅,表示过期原因,取值包括:

● 1:用户取消

● 2:商品不可用

● 3:用户签约信息异常

● 4:Billing错误

● 5:用户未同意涨价

● 6:未知错误

Method
public int getRetryFlag()
一个过期的订阅,系统是否仍然在尝试自动完成续期处理。
Method
public int getIntroductoryFlag()
是否处于促销价续期周期内。
Method
public int getTrialFlag()
是否处于免费试用周期内。
Method
public long getCancelTime()
取消时间的时间戳。在顾客投诉,通过客服取消订阅,或者顾客升级、跨级到同组其他商品并且立即生效场景下,需要取消原有订阅的上次收据时有值。
Method
public int getCancelReason()
取消原因。
● 2:顾客升级、跨级等。
● 1:顾客因为在App内遇到了问题而取消了订阅。
● 0:其他原因取消,比如顾客错误地订阅了商品。
Method
public java.lang.String getAppInfo()
App信息,预留。
Method
public int getNotifyClosed()
用户是否已经关闭订阅上的通知。
Method
public int getRenewStatus()

续期状态。

● 1:当前周期到期时自动续期。

● 0:用户停止了续期。

Method
public int getPriceConsentStatus()
商品提价时的用户意见。
● 1:用户已经同意提价。
● 0:用户未采取动作,超期后订阅失效。
Method
public long getRenewPrice()
下次续期价格。在有priceConsentStatus情况下,供客户端参考,用于提示用户新的续期价格。
Method
public boolean isSubValid()
为true表示商品已经收费且未过期,也没有发生退款,开发者可以基于该标志为用户提供服务。
为false表示未完成购买或者已经过期,或者购买后已经退款。
Method
public int getCancelledSubKeepDays()

用户取消后订阅关系保留的天数,并不表示本订阅已经取消。

Method
public boolean getKind()

商品类别,取值包括:

● 0:消费

● 1:非消费

● 2:续期商品

● 3:非续期商品。

Method
public boolean getDeveloperChallenge()

应用发起消耗请求时自定义的挑战字,可唯一标识此次消耗请求,仅一次性商品存在。

Method
public boolean getConsumptionState()

消费状态,仅一次性商品存在,取值包括:

● 0:未消费

● 1:已消费

Method
public boolean getPayOrderId()
交易订单号。
Method
public boolean getPayType()
支付方式,取值:
● 0:花币
● 3:信用卡
● 4:支付宝
● 6:话费
● 13:PayPal
● 16:借记卡
● 17:微信
● 19:礼品卡
● 20:零钱
● 21:花币卡
● 24:WP
● 31:华为Pay
● 32:花呗
● 200:MPESA
Method
public boolean getDeferFlag()
是否延迟结算,Integer,1:是。
Method
public boolean getOriSubscriptionId()
原订阅ID。有值表示当前订阅是从其他商品切换来的,该值可以关联切换前的商品订阅信息。
Method
public boolean getCancelWay()
取消订阅途径,0:顾客;1:开发者;2:华为
Method
public boolean getCancellationTime()
取消订阅时间,UTC时间戳 。
注:cancelWay,cancellationTime特指订阅续期停止,不涉及退款。
Method
public long getResumeTime()
订阅商品暂停订阅后的恢复时间。
Method
public int getAccountFlag()
获取帐号类型。取值如下:
  • 1:AppTouch用户账号

  • 其他:华为帐号

本页面可能包含由第三方许可的内容,请参考具体描述
在 API参考 中进行搜索
请输入您想要搜索的关键词