> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken

> Ponto de extremidade de token SAS de estorno da Microsoft Store v8 que gera um token SAS do Armazenamento do Azure para ler a fila de mensagens de eventos de Clawback do seu serviço de jogo.

Este ponto de extremidade gera um [token SAS](https://learn.microsoft.com/azure/storage/common/storage-sas-overview) para autenticar e acessar sua fila de mensagens de eventos de Clawback.
Para obter mais informações sobre uma fila de mensagens de eventos de Clawback, confira [Gerenciar reembolsos e estornos do seu serviço](/pt-BR/publishing/xstore-commerce/xstore-managing-refunds).

## Pré-requisitos

Revise os [Pré-requisitos para APIs de serviço a serviço](/pt-BR/publishing/xstore-commerce/xstore-authenticating-service).

Para usar esta API, você deve passar pelo processo de integração com a assistência do seu Developer Partner Manager ou contato da Microsoft.
Para obter mais informações sobre o processo de integração, confira [Configuração necessária / solicitação de integração](/pt-BR/publishing/xstore-commerce/xstore-managing-refunds#required-setup--onboarding-request).

## Solicitação

### Sintaxe da solicitação

| Método | URI da solicitação |
| - | - |
| `GET` | `purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken` |

### Cabeçalho da solicitação

| Cabeçalho | Tipo | Descrição |
| - | - | - |
| `Authorization` | `string` | Obrigatório. Seu token de acesso de serviço do Microsoft Entra ID no formato `Bearer` \<*token*>. Confira [Criar tokens de acesso do Microsoft Entra ID](/pt-BR/publishing/xstore-commerce/xstore-requesting-userstoreid#step-3-creating-microsoft-entra-id-access-tokens). |
| `Host` | `string` | Deve ser definido com o valor `purchase.mp.microsoft.com`. |

### Exemplo de solicitação

```html theme={null}
GET https://purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken HTTP/1.1
Host: purchase.mp.microsoft.com
Authorization: Bearer [Microsoft Entra ID bearer token]
```

## Resposta

### Corpo da resposta

O corpo da resposta é JSON com os valores a seguir.

| Parâmetro | Tipo | Descrição | Obrigatório |
| - | - | - | - |
| `expiresOn` | `DateTime` | A data e a hora UTC em que o token SAS expira | Sim |
| `uri` | `string` | URI do recurso de armazenamento combinado com o [token SAS](https://learn.microsoft.com/azure/storage/common/storage-sas-overview) para acessar a fila de mensagens de Clawback. | Sim |

### Exemplo de resposta

```json theme={null}

HTTP/1.1 200 OK
Date: Thu, 08 Dec 2022 20:13:46 GMT
Content-Length: 243
Content-Type: application/json; charset=utf-8
ms-correlationid: 70e6f659-ceee-4050-bdf3-56ea3beefe23
ms-requestid: 8c80d7ff-73e2-4a5c-9aca-79059fbc1beb
ms-cv: tRscYtHLJHps.0
x-content-type-options: nosniff

{
    "expiresOn":"2022-12-09T02:13Z",
    "uri":"https://uluufeofsxh2k.queue.core.windows.net:443/gxhxcvb32lnk4?sv=2021-10-04&spr=https&st=2022-12-08T20%3A13%3A46Z&se=2022-12-09T02%3A13%3A46Z&sp=rp&sig=OneHfX99E820avICZvXJUF14IyDuv2BrvY0kj%2Ftxc70%3D"
}

```

## Usar o token SAS para acessar a fila de mensagens de eventos de Clawback

Depois de obter o parâmetro `uri`, você poderá acessar as mensagens da fila.
Para obter mais informações, confira [Processar mensagens de Clawback da fila](/pt-BR/publishing/xstore-commerce/xstore-managing-refunds#processing-clawback-messages-from-the-queue).

## Artigos relacionados

[Gerenciar reembolsos e estornos do seu serviço](/pt-BR/publishing/xstore-commerce/xstore-managing-refunds)

[Gerenciar produtos consumíveis do seu serviço](/pt-BR/publishing/xstore-commerce/xstore-managing-consumables)

[Gerenciar produtos dos seus serviços](/pt-BR/publishing/xstore-commerce/xstore-authenticating-service)

[Autenticar seu serviço com as APIs da Microsoft Store](/pt-BR/publishing/xstore-commerce/xstore-authenticating-service)

[APIs REST do Armazenamento de Filas do Azure](https://learn.microsoft.com/rest/api/storageservices/queue-service-rest-api)

[Armazenamento de Filas do Azure usando .NET](https://learn.microsoft.com/azure/storage/queues/storage-dotnet-how-to-use-queues?tabs=dotnet)


## Related topics

- [APIs de serviço da Microsoft Store](/pt-BR/reference/microsoft-store-apis/xstore-nav.md)
- [Gerenciando produtos consumíveis a partir do seu serviço](/pt-BR/publishing/xstore-commerce/xstore-managing-consumables.md)
- [purchase.mp.microsoft.com/v8.0/b2b/orders/query](/pt-BR/reference/microsoft-store-apis/xstore-v8-clawbackv1.md)
- [purchase.mp.microsoft.com/v8.0/b2b/recurrences/query](/pt-BR/reference/microsoft-store-apis/xstore-v8-recurrence-query.md)
- [purchase.mp.microsoft.com/v8.0/purchases/grant](/pt-BR/reference/microsoft-store-apis/xstore-v8-grant.md)