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

  • Artigo

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:

  1. 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);

  2. 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/87363db7-39ab-dd25-d371-94340aaa2f97/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
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: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"87363db7-39ab-dd25-d371-94340aaa2f97",
    "status":"Success"
}