Ativar uma assinatura sandbox para produtos SaaS do mercado comercial para habilitar a cobrança

Artigo
03/14/2024

Como ativar uma subscrição para produtos de software como serviço (SaaS) do mercado comercial a partir de contas sandbox de integração para permitir a faturação.

Nota

Só é possível ativar uma assinatura para produtos SaaS do mercado comercial a partir de contas sandbox de integração. Se você tiver uma assinatura de produção, deverá visitar o site do editor para concluir o processo de configuração. A cobrança da assinatura começará somente após a conclusão da configuração.

Pré-requisitos

Credenciais conforme descrito na autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Uma conta de parceiro sandbox de integração com um cliente com uma assinatura ativa para produtos SaaS do mercado comercial.
Para parceiros que usam o SDK .NET do Partner Center, você deve usar o SDK versão 1.14.0 ou superior para acessar esse recurso.

Importante

A partir de junho de 2023, a versão 3.4.0 mais recente do SDK do .NET do Partner Center foi arquivada. Você pode baixar a versão do SDK do GitHub, juntamente com um arquivo readme que contém informações úteis.

Os parceiros são incentivados a continuar a usar as APIs REST do Partner Center.

C#

Use as seguintes etapas para ativar uma assinatura para produtos SaaS do mercado comercial:

Disponibilize uma interface para as operações de subscrição. Você deve identificar o cliente e especificar o identificador de assinatura da assinatura de avaliação.
```
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
```

Ative a assinatura usando a operação Ativar .

var subscriptionActivationResult = subscriptionOperations.Activate();

Pedido REST

Sintaxe da solicitação

Método	URI do pedido
POST	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

Parâmetro URI

Nome	Tipo	Necessário	Descrição
ID do cliente-locatário	GUID	Y	O valor é um identificador de locatário do cliente formatado em GUID (customer-tenant-id), que permite especificar um cliente.
ID da subscrição	GUID	Y	O valor é um identificador de assinatura formatado em GUID (subscription-id), que permite especificar uma assinatura.

Cabeçalhos do pedido

Para obter mais informações, consulte Cabeçalhos REST do Partner Center.

Corpo do pedido

Nenhum.

Exemplo de solicitação

POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

Resposta do REST

Esse método retorna as propriedades subscription-id e status .

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "status":"Success"
}

Partilhar via