App Store
App Store Server Notification types for commissions
App Store Server Notification types are the notificationType values Apple sends for subscription lifecycle events. Attribloom maps them to commission actions: confirm, hold, renew, or reverse.
Published · Last reviewed
Written by Attribloom Engineering · Reviewed by Attribloom Product · Last reviewed
App Store Server Notifications v2 each carry a notificationType that names the lifecycle event. Attribloom verifies the signed payload, reads the appAccountToken, and moves the commission state based on that type.
As a general map, a new subscription (SUBSCRIBED) confirms the conversion and accrues commission; a renewal (DID_RENEW) accrues again for the same affiliate; a refund (REFUND) reverses the matching commission through a clawback; and a revocation (REVOKE) removes access to a purchase, which reverses attribution for it. Apple's notificationType reference is the authoritative list of values and their meanings, so treat that page as the source of truth and phrase edge cases conservatively.
Frequently asked
Which notification confirms a commission?
A first paid subscription (SUBSCRIBED) confirms the conversion, and each DID_RENEW accrues commission again for the same affiliate. Both carry the appAccountToken Attribloom uses to attribute.
Which notifications reverse a commission?
A REFUND reverses the matching transaction's commission, and a REVOKE removes access to a purchase and reverses its attribution. Apple's notificationType documentation defines each event precisely.