revokedSeatQuantity
The number of seats in a transaction that a seat-based refund revoked.
Declaration
int32 revokedSeatQuantityMentioned in
Discussion
A seat-based refund revokes some of the seats in a subscription that a customer buys as a multiseat purchase, without revoking the transaction. The transaction remains valid for its remaining seats. When a seat-based refund applies to a transaction, the App Store sends a REFUND notification with a subtype of SEATS. For more information, see subtype.
Only the group purchaser’s transaction contains revokedSeatQuantity. Don’t revoke the group purchaser’s access because of this value. Revoke it only when every transaction in the period contains revocation fields, such as revocationDate.
For a subscription with an invitationManagement value of
APPLE, you don’t need to act on this value; the App Store reduces the number of seats the group purchaser can assign.For a subscription with a value of
DEVELOPER, use this value to update your record of the number of seats, or call the Get Seat Info endpoint to get the current totalSeatCount.
The TransactionMultiSeatInfo object contains this value when a seat-based refund applies to the transaction. If a refund covers seats from more than one transaction in the period, each of those transactions reports its own revokedSeatQuantity, and you receive a notification for each one. If every seat in the transaction is revoked, the transaction contains revocation fields, such as revocationDate, instead of revokedSeatQuantity.