What does the App Store notification DID_RENEW mean?

The App Store notification DID_RENEW means an auto-renewable subscription renewed successfully for a new period.

Quick facts#


Notification	`notificationType` `DID_RENEW`
Where	App Store Server Notifications v2 (`responseBodyV2DecodedPayload`)
Sent by	The App Store server, to your notification URL
What Apple says	The subscription renewed. With subtype BILLING_RECOVERY, a subscription that previously failed to renew has now renewed. With no subtype, an active subscription auto-renewed.

What triggers it#

Without a subtype, the active subscription auto-renewed for a new transaction period.
Subtype BILLING_RECOVERY: the expired subscription that had failed to renew has renewed after the billing retry.
Apple says to give the customer access to the subscription's content or service.

What your server should do#

Verify the signedPayload with Apple's App Store Server Library (SignedDataVerifier.verifyAndDecodeNotification) before you act on anything in it.
Read the new expiresDate from signedTransactionInfo and extend access to it.
If you showed a billing warning, remove it when the subtype is BILLING_RECOVERY.
Answer HTTP 200 (any code from 200 to 206) once you have stored the notification. Apple retries other answers five times, at 1, 12, 24, 48 and 72 hours after the previous attempt, so make your handler safe to run twice (the payload carries a notificationUUID).

Example#

JavaScript

// Run on the decoded payload, after you verified Apple's signature.
const notification = {"notificationType":"DID_RENEW","data":{"environment":"Sandbox","bundleId":"com.example.app"}};

function decide(n) {
  if (n.notificationType !== "DID_RENEW") return "ignore";
  return n.subtype === "BILLING_RECOVERY" ? "extend access, clear the billing warning" : "extend access";
}

console.log(decide(notification));

Run-checked: npm run check:snippets runs this snippet with Node and compares its output with extend access (checked 2026-10-03).

How RevenueDot handles it#

RevenueDot verifies Apple's signature, checks the bundle ID, stores the notification and answers 200. A purchase RevenueDot has not seen is applied only when the app's Track new purchases from server-to-server notifications setting is on. DID_RENEW clears the billing issue on the stored purchase (a type override in the server code) and applies the new transaction. A new period gives a RENEWAL event, with is_trial_conversion: true when the previous period was a free trial. Recovering a failed payment is reported as RENEWAL, never as UNCANCELLATION.

Source#

Checked: 2026-10-03

Edit this page on GitHub ↗ View as Markdown Last updated October 3, 2026