<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "AdvancedCommerceAPI",
  "identifier" : "/documentation/AdvancedCommerceAPI/Revoke-Subscription",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Advanced Commerce API"
    ],
    "preciseIdentifier" : "rest:advanced-commerce-api:post:advancedCommerce-v1-subscription-revoke-{}"
  },
  "title" : "Revoke Subscription"
}
-->

# Revoke Subscription

Immediately cancel a customer’s subscription and all the items that are included in the subscription, and request a full or prorated refund.

## Discussion

When this endpoint succeeds, the system sets the subscription’s auto-renew status to `false`, and revokes the subscription with a full or prorated refund. The App Store Server Notifications sends a `REFUND`  <doc://com.apple.documentation/documentation/AppStoreServerNotifications/notificationType> to your <doc://com.apple.documentation/documentation/AppStoreServerNotifications/App-Store-Server-Notifications-V2> endpoint.
Check the `revocationDate` property in the notification’s  <doc://com.apple.documentation/documentation/AppStoreServerNotifications/JWSTransactionDecodedPayload>. Turn off service for the subscription and its items as of the revocation date. Don’t turn off service to the subscription until you receive the notification.

To cancel a subscription at the end of the current period instead, see [`Cancel a Subscription`](/documentation/AdvancedCommerceAPI/Cancel-a-Subscription).

> Note: To use the `Revoke Subscription` endpoint, your membership Account Holder must sign the Advanced Commerce API Addendum, and you must meet certain eligibility requirements. For more information, see [Advanced Commerce API](https://developer.apple.com/in-app-purchase/advanced-commerce-api/). If the most recent version of this agreement isn’t yet accepted, you can’t call this endpoint, and it returns an error.

Refer to the Advanced Commerce API Addendum to learn the use cases for the [`Cancel a Subscription`](/documentation/AdvancedCommerceAPI/Cancel-a-Subscription), `Revoke Subscription`, and [`Request Transaction Refund`](/documentation/AdvancedCommerceAPI/Request-Transaction-Refund) APIs.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)