适用于 App Store Server Notifications Version 2
CONSUMPTION_REQUEST
一种通知类型,指示客户对消耗品应用内购或自动续订订阅发起退款请求,应用商店要求您提供消费数据。有关详细信息,请参阅发送消费信息。
DID_CHANGE_RENEWAL_PREF
通知类型及其subtype,指示客户对其订阅计划进行了更改。如果subtype
是UPGRADE
,则用户升级了订阅。升级立即生效,开始新的计费周期,用户将收到上一周期未使用部分的按比例退款。如果subtype
是DOWNGRADE
,则客户降级了订阅。降级在下一个续订日期生效,不会影响当前活动的计划。
如果subtype
为空,则用户将其续订首选项更改回当前订阅,从而有效地取消降级。
有关订阅级别的详细信息,请参阅对组内的订阅进行排名。
DID_CHANGE_RENEWAL_STATUS
通知类型及其subtype,指示客户更改了订阅续订状态。如果subtype
为AUTO_RENEW_ENABLED
,则客户重新启用订阅自动续订。如果subtype
为AUTO_RENEW_DISABLED
,则客户禁用订阅自动续订,或客户请求退款后App Store禁用订阅自动续订。
DID_FAIL_TO_RENEW
一种通知类型及其subtype,指示订阅由于计费问题未能续订。订阅进入计费重试期。如果subtype
为GRACE_PERIOD
,则在宽限期内继续提供服务。如果subtype
为空,则订阅不在宽限期内,您可以停止提供订阅服务。
通知客户他们的计费信息可能有问题。App Store会在60天内继续重试计费,或者直到客户解决计费问题或取消订阅,以先到者为准。有关详细信息,请参阅减少非自愿订阅者流失。
DID_RENEW
一种通知类型,连同它的subtype一起,指示订阅成功续订。如果subtype
为BILLING_RECOVERY
,则先前续订失败的过期订阅已成功续订。如果子状态为空,则活动订阅已成功自动续订一个新的事务周期。为客户提供对订阅内容或服务的访问权限。
EXPIRED
一种通知类型及其subtype,指示订阅已过期。如果subtype
是VOLUNTARY
的,则订阅在用户禁用订阅续订后过期。如果subtype
是BILLING_RETRY
,则订阅过期,因为计费重试期结束时没有成功计费事务。如果subtype
是PRICE_INCREASE
,则订阅过期,因为客户不同意需要客户同意的价格上涨。如果subtype
是PRODUCT_NOT_FOR_SALE
,则订阅过期,因为在订阅尝试续订时产品无法购买。
没有subtype
的通知表示订阅因其他原因过期。
EXTERNAL_PURCHASE_TOKEN
通知类型及其subtype UNREPORTED
表示Apple为您的应用创建了外部购买令牌,但没有收到报告。有关报告令牌的详细信息,请参阅externalPurchaseToken。
此通知仅适用于使用外部购买API提供替代支付选项的应用。
GRACE_PERIOD_EXPIRED
一种通知类型,指示计费宽限期已结束而未续订订阅,因此您可以关闭对服务或内容的访问。通知客户他们的计费信息可能存在问题。App Store将继续重试计费60天,或直到客户解决其计费问题或取消其订阅,以先到者为准。有关详细信息,请参阅减少非自愿订阅者流失。
OFFER_REDEEMED
一种通知类型及其subtype,指示客户兑换了促销优惠或优惠代码。
如果subtype
是INITIAL_BUY
,则客户为首次购买兑换了报价。如果subtype
是RESUBSCRIBE
,则客户兑换了重新订阅非活动订阅的报价。如果subtype
是UPGRADE
,则客户兑换了升级活动订阅的报价,该报价立即生效。如果subtype
是DOWNGRADE
,则客户兑换了降级活动订阅的报价,该报价在下一个续订日期生效。如果客户为活动订阅兑换了报价,则您会收到一个没有subtype
的OFFER_REDEEMED
通知类型。
有关促销优惠的详细信息,请参阅在您的应用中实施促销优惠。有关订阅优惠代码的详细信息,请参阅在您的应用中实施优惠代码。
ONE_TIME_CHARGE
目前ONE_TIME_CHARGE
通知仅在沙盒环境中可用。
一种通知类型,指示客户购买了消耗品、非消耗品或非续订订阅。当客户通过家庭共享获得对非消耗品产品的访问权限时,App Store也会发送此通知。
有关自动续订订阅购买的通知,请参阅SUBSCRIBED
通知类型。
PRICE_INCREASE
一种通知类型及其subtype,指示系统已通知客户自动续订订阅价格上涨。
如果涨价需要客户同意,则subtype
为PENDING
(如果客户没有响应涨价),或ACCEPTED
)(如果客户同意涨价)。
如果价格上涨不需要客户同意,subtype
将ACCEPTED
。
有关系统在显示需要客户同意的订阅价格上涨的价格同意表之前如何调用应用的信息,请参阅paymentQueueShouldShowPriceConsent(_:)。有关管理订阅价格的信息,请参阅管理自动续订订阅的价格上涨和管理价格。
REFUND
一种通知类型,指示App Store成功为消耗性应用内购、非消耗性应用内购、自动续订订阅或非续订订阅退款。
该revocationDate包含退款交易的时间戳。originalTransactionId和productId标识原始交易和产品。revocationReason包含原因。
要为客户请求所有退款交易的列表,请参阅App Store Server API中的获取退款历史记录。
REFUND_DECLINED
指示App Store拒绝退款请求的通知类型。
REFUND_REVERSED
一种通知类型,表明App Store因客户提出的争议而撤销了先前授予的退款。如果您的应用因相关退款而撤销了内容或服务,则需要恢复它们。
此通知类型可适用于任何应用内购类型:消耗品、非消耗品、非续订订阅和自动续订订阅。对于自动续订订阅,当App Store逆转退款时,续订日期保持不变。
RENEWAL_EXTENDED
一种通知类型,指示应用商店延长了特定订阅的订阅续订日期。您可以通过调用扩展订阅续订日期或在应用商店服务器应用编程接口中为所有活跃订阅者扩展订阅续订日期来请求subscription-renewal-date续订。
RENEWAL_EXTENSION
一种通知类型及其subtype,指示App Store正在尝试通过调用为所有活跃订阅者延长订阅续订日期来延长您请求的订阅续订日期。
如果subtype
为SUMMARY
,则App Store已为所有符合条件的订阅者延长续订日期。有关详细信息,请参阅responseBodyV2DecodedPayload中的summary
。如果subtype
为FAILURE
,则特定订阅的续订日期延长未成功。有关详细信息,请参阅responseBodyV2DecodedPayload
中的data
。
REVOKE
一种通知类型,表明客户通过家庭共享有权获得的应用内购不再通过共享可用。当购买者为其购买禁用家庭共享、购买者(或家庭成员)离开家庭组或购买者收到退款时,App Store会发送此通知。您的应用还会收到paymentQueue(_:didRevokeEntitlementsForProductIdentifiers:)呼叫。家庭共享适用于非消耗性站内消费和自动续订订阅。有关家庭共享的更多信息,请参阅在您的应用中支持家庭共享。
SUBSCRIBED
一种通知类型及其subtype,指示客户订阅了自动续订订阅。如果subtype
是INITIAL_BUY
,则客户首次通过家庭共享购买或获得对该订阅的访问权限。如果subtype
是RESUBSCRIBE
,则用户通过家庭共享重新订阅或获得对同一订阅或同一订阅组内另一个订阅的访问权限。
有关其他产品类型购买的通知,请参阅ONE_TIME_CHARGE
通知类型。
TEST
App Store服务器在您请求时通过调用请求测试通知端点发送的通知类型。调用该端点以测试您的服务器是否正在接收通知。您仅在请求时收到此通知。有关故障排除信息,请参阅获取测试通知状态端点。