Cgoodwin/windows store id key updates (#5035)

* Updated lifetime to 30 days, Azure AD -> Entra ID, and renewal ability now only while

* Adding missed / for link

* fixing a few typos

Author: CameronGoodwin

uwp/monetize/renew-a-windows-store-id-key.md

@@ -2,25 +2,31 @@
 ms.assetid: 3569C505-8D8C-4D85-B383-4839F13B2466
 description: Learn how to renew an expired Microsoft Store ID key using the renew method in the Microsoft Store collection and purchase APIs.
 title: Renew a Microsoft Store ID key
-ms.date: 04/22/2021
+ms.date: 12/06/2024
 ms.topic: article
 keywords: windows 10, uwp, Microsoft Store collection API, Microsoft Store purchase API, Microsoft Store ID key, renew
 ms.localizationpriority: medium
 ---
 # Renew a Microsoft Store ID key
 
-
-Use this method to renew a Microsoft Store key. When you [generate a Microsoft Store ID key](view-and-grant-products-from-a-service.md#step-4), the key is valid for 90 days. After the key expires, you can use the expired key to renegotiate a new key by using this method.
+Use this method to renew a Microsoft Store key. When you [generate a Microsoft Store ID key](view-and-grant-products-from-a-service.md#step-4), the key is valid for 30 days. Before the key expires, you can use it to renegotiate a new key by using this method.
 
 The [Microsoft.StoreServices library](https://github.com/microsoft/Microsoft-Store-Services) provides the functionality of this method through the UserStoreId.RefreshStoreId API.
 
+> [!NOTE]
+> Previously Microsoft Store keys had a longer lifetime and in some cases were able to be renewed after the key had already expired.
+> Now, developers should only expect keys to be renewable during their lifetime and should note the expire date on the keys in order to renew them before they expire.
 
-## Prerequisites
+> [!IMPORTANT]
+> Although Microsoft Store keys are able to be renewed before they expire, the keys may be revoked prior to their expire dates in response to security concerns.
+> Therefore, your services should handle the case where a renewal attempt fails with the AuthenticationTokenInvalid.
+> In this case, you should generate a new Microsoft Store key for the user on the client or the method used to generate the original Microsoft Store key.
 
+## Prerequisites
 
 To use this method, you will need:
 
-* An Azure AD access token that has the audience URI value `https://onestore.microsoft.com`.
+* An Entra ID access token that has the audience URI value `https://onestore.microsoft.com/.default`.
 * An expired Microsoft Store ID key that was [generated from client-side code in your app](view-and-grant-products-from-a-service.md#step-4).
 
 For more information, see [Manage product entitlements from a service](view-and-grant-products-from-a-service.md).
@@ -34,7 +40,6 @@ For more information, see [Manage product entitlements from a service](view-and-
 | Collections | POST   | ```https://collections.mp.microsoft.com/v6.0/b2b/keys/renew``` |
 | Purchase    | POST   | ```https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew```    |
 
-
 ### Request header
 
 | Header         | Type   | Description                                                                                           |
@@ -43,15 +48,13 @@ For more information, see [Manage product entitlements from a service](view-and-
 | Content-Length | number | The length of the request body.                                                                       |
 | Content-Type   | string | Specifies the request and response type. Currently, the only supported value is **application/json**. |
 
-
 ### Request body
 
 | Parameter     | Type   | Description                       | Required |
 |---------------|--------|-----------------------------------|----------|
-| serviceTicket | string | The Azure AD access token.        | Yes      |
+| serviceTicket | string | The Entra ID access token.        | Yes      |
 | key           | string | The expired Microsoft Store ID key. | Yes       |
 
-
 ### Request example
 
 ```syntax
@@ -68,14 +71,12 @@ Host: collections.mp.microsoft.com
 
 ## Response
 
-
 ### Response body
 
 | Parameter | Type   | Description                                                                                                            |
 |-----------|--------|------------------------------------------------------------------------------------------------------------------------|
 | key       | string | The refreshed Microsoft Store key that can be used in future calls to the Microsoft Store collections API or purchase API. |
 
-
 ### Response example
 
 ```syntax
@@ -95,16 +96,13 @@ Date: Tue, 13 Sep 2015 07:31:12 GMT
 
 ## Error codes
 
-
 | Code | Error        | Inner error code           | Description   |
 |------|--------------|----------------------------|---------------|
-| 401  | Unauthorized | AuthenticationTokenInvalid | The Azure AD access token is invalid. In some cases the details of the ServiceError will contain more information, such as when the token is expired or the *appid* claim is missing. |
-| 401  | Unauthorized | InconsistentClientId       | The *clientId* claim in the Microsoft Store ID key and the *appid* claim in the Azure AD access token do not match.                                                                     |
-
+| 401  | Unauthorized | AuthenticationTokenInvalid | The Entra ID access token or the Microsoft Store Key being renewed are invalid. In some cases the details of the ServiceError will contain more information, such as when the token is expired or the *appid* claim is missing. |
+| 401  | Unauthorized | InconsistentClientId       | The *clientId* claim in the Microsoft Store ID key and the *appid* claim in the Entra ID access token do not match.                                                                     |
 
 ## Related topics
 
-
 * [Manage product entitlements from a service](view-and-grant-products-from-a-service.md)
 * [Query for products](query-for-products.md)
 * [Report consumable products as fulfilled](report-consumable-products-as-fulfilled.md)