模型字段如下表:
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
applicationId | 是 | Long | 应用ID。 |
autoRenewing | 是 | Boolean | 消耗型商品或者非消耗型商品:固定为false。 订阅型商品:
|
orderId | 是 | String | 订单ID,唯一标识一笔需要收费的收据,由华为应用内支付服务器在创建订单以及订阅型商品续费时生成。 每一笔新的收据都会使用不同的orderId。 |
kind | 是 | Integer | 商品类别,取值包括:
|
packageName | 否 | String | 应用安装包名。 |
productId | 是 | String | 商品ID。每种商品必须有唯一的ID,由应用在PMS中维护,或者应用发起购买时传入。 说明: 为避免资金损失,您在对支付结果验签成功后,必须对其进行校验。 |
productName | 否 | String | 商品名称。 |
purchaseTime | 否 | Long | 商品购买时间,UTC时间戳,以毫秒为单位。 |
purchaseTimeMillis | 否 | Long | 历史接口兼容用,同purchaseTime,新接入无需关注本字段。 |
purchaseState | 是 | Integer | 订单交易状态。
|
developerPayload | 否 | String | 商户侧保留信息,由您在调用支付接口时传入。 说明: 请勿传入个人敏感信息。 |
developerChallenge | 否 | String | 应用发起消耗请求时自定义的挑战字,可唯一标识此次消耗请求,仅一次性商品存在。 |
consumptionState | 否 | Integer | 消耗状态,仅一次性商品存在,取值包括:
|
confirmed | 否 | Integer | 确认状态,取值包括:
说明: 该字段当前仅做兼容用,您无需关注。 |
purchaseToken | 是 | String | 用于唯一标识商品和用户对应关系的购买令牌,在支付完成时由华为应用内支付服务器生成。 说明:
|
purchaseType | 否 | Integer | 购买类型。
正式购买不会返回该参数。 |
currency | 否 | String | 定价货币的币种,请参见ISO 4217标准。 说明: 为避免资金损失,您在对支付结果验签成功后,必须对其进行校验。 |
price | 否 | Long | 商品实际价格*100以后的值。商品实际价格精确到小数点后2位,例如此参数值为501,则表示商品实际价格为5.01。 说明: 为避免资金损失,您在对支付结果验签成功后,必须对其进行校验。 |
country | 否 | String | 国家/地区码,用于区分国家/地区信息,请参见ISO 3166标准。 |
payType | 否 | String | 支付方式,取值请参见payType说明。 |
payOrderId | 否 | String | 交易单号,用户支付成功后生成。 |
以下参数只在订阅场景返回 | |||
lastOrderId | 是 | String | 上次续期收款的订单ID,由支付服务器在续期扣费时生成。首次购买订阅型商品时的lastOrderId与orderId数值相同。 |
productGroup | 否 | String | 订阅型商品所属的订阅组ID。 |
oriPurchaseTime | 否 | Long | 原购买的时间,即本订阅型商品首次成功收费的时间,UTC时间戳,以毫秒为单位。 |
subscriptionId | 否 | String | 订阅ID。 说明: subscriptionId是用户与商品之间的一一对应关系,在订阅型商品正常续订时不会改变。 |
oriSubscriptionId | 否 | String | 原订阅ID。有值表示当前订阅是从其他商品切换来的,该值可以关联切换前的商品订阅信息 |
quantity | 否 | Integer | 购买数量。 |
daysLasted | 否 | Long | 已经付费订阅的天数,免费试用和促销期周期除外。 |
numOfPeriods | 否 | Long | 成功标准续期(没有设置促销的续期)的期数,为0或者不存在表示还没有成功续期。 |
numOfDiscount | 否 | Long | 成功促销续期期数。 |
expirationDate | 否 | Long | 订阅型商品过期时间,UTC时间戳,以毫秒为单位。 对于一个成功收费的自动续订收据,该时间表示续期日期或者超期日期。如果商品最近的收据的该时间是一个过去的时间,则订阅已经过期。 |
expirationIntent | 否 | Integer | 对于已经过期的订阅,表示过期原因,取值包括:
同时有多个异常时,优先级为:1 > 2 > 3… |
retryFlag | 否 | Integer | 一个过期的订阅,系统是否仍然在尝试自动完成续期处理。取值包括:
|
introductoryFlag | 否 | Integer | 是否处于促销价续期周期内。
|
trialFlag | 否 | Integer | 是否处于免费试用周期内。
|
cancelTime | 否 | Long | 订阅撤销时间,UTC时间戳,以毫秒为单位,发生退款且服务立即不可用。在顾客投诉,通过客服撤销订阅,或者顾客升级、跨级到同组其他商品并且立即生效场景下,需要撤销原有订阅的上次收据时有值。 说明: 已经撤销的收据等同于没有完成购买。 |
cancelReason | 否 | Integer | 取消原因。
说明: 如果为空且cancelTime有值,表示是升级等操作导致的取消。 |
appInfo | 否 | String | App信息,预留。 |
notifyClosed | 否 | Integer | 用户是否已经关闭订阅上的通知,
关闭状态下,订阅相关的通知均不会发送给用户。 说明: 仅在查询订阅关系时返回。 |
renewStatus | 否 | Integer | 续期状态。
仅针对自动续期订阅,对有效和过期的订阅均有效,并不代表顾客的订阅状态。通常,取值为0时,应用可以给顾客提供其他的订阅选项,例如推荐一个同组更低级别的商品。该值为0通常代表着顾客主动取消了该订阅。 |
priceConsentStatus | 否 | Integer | 商品提价时的用户意见。
|
renewPrice | 否 | Long | 下次续期价格。在有priceConsentStatus情况下,供客户端参考,用于提示用户新的续期价格。 |
subIsvalid | 否 | Boolean |
说明: 如果顾客已经取消订阅,在已经购买的商品过期之前,subIsvalid仍然为True。 |
deferFlag | 否 | Integer | 是否延迟结算。
|
cancelWay | 否 | Integer | 取消订阅途径。
|
cancellationTime | 否 | Long | 用户取消订阅的时间,UTC时间戳,以毫秒为单位。在该时间进行了订阅续期停止的设定,商品在有效期内仍然有效,但后续的续期会终止,无退款。 说明: cancellationTime特指订阅续期停止,不涉及退款。 |
cancelledSubKeepDays | 否 | Integer | 用户取消后订阅关系保留的天数,并不表示本订阅已经取消。 |
resumeTime | 否 | Long | 一个暂停的订阅的恢复时间,UTC时间戳,以毫秒为单位。 |
surveyReason | 否 | Integer | 顾客取消原因: 0:其他原因 1:费用过高,用户反悔 2:技术问题,比如商品未提供 5:欺诈,禁用清单 7:商品切换 8:华为账号切换服务地 9:较少使用,不再需要该服务 10:有其他更好应用 |
surveyDetails | 否 | String | 在surveyReason为0的时候,收集顾客输入的取消原因。 |
graceExpirationTime | 否 | Long | 订阅型商品宽限期过期的时间,UTC时间戳,以毫秒为单位。 |
取值 | 说明 |
|---|---|
0 | 花币 |
3 | 信用卡 |
4 | 支付宝 |
6 | 话费 |
13 | PayPal |
16 | 借记卡 |
17 | 微信 |
19 | 礼品卡 |
20 | 零钱 |
21 | 花币卡 |
23 | callfee |
24 | World Pay |
31 | HUAWEI Wallet |
32 | 支付宝花呗 |
33 | SHARINGPAY |
34 | bankCard |
35 | Ideal |
36 | OpenBK |
37 | Sofort |
38 | giropay |
39 | FPX |
40 | eNets |
41 | BOOST |
42 | Sberbank |
43 | eMoney |
44 | 花呗 |
45 | Coupon(HMS优惠券支付) |
46 | eMoney4MP |
47 | 2C2PBank |
48 | TrueMoney |
49 | 礼品卡和HMS优惠券组合支付 |
61 | GCash |
62 | BPIOnline |
63 | UnionBankOnline |
64 | alipay_hk |
65 | DANA |
66 | TNG |
67 | PaymentWall |
68 | paymaya_wallet |
69 | PSafeCard |
70 | MPESA |
71 | BankCard |
72 | WXPay |
73 | AliPay |
74 | Boost |
75 | oxxopay |
76 | ALIPAY_HK |
77 | GCASH |
78 | Efecty |
79 | Multicaja |
80 | PayAtFawry |
81 | Point(纯积分支付) |
82 | HWPay4Petal |
83 | TRUEMONEY |
84 | MIR |
85 | Boost |
86 | vtcpay |
88 | Webpay |
89 | PSE |
90 | ozow |
93 | ShopeePay |
94 | 华为支付 |
95 | 云闪付 |
97 | QIWI |
98 | trustly |
99 | knet |
100 | pagoefectivo |
102 | Tinkoff |
103 | 香港微信支付 |
105 | AliPayCN |
106 | MercadoPago |
108 | QIWI银行卡 |
109 | PIX |
110 | Maya |
113 | VKPay银行卡 |