Ativar uma assinatura de área restrita para produtos SaaS do marketplace comercial para habilitar o faturamento

  • Artigo

Como ativar uma assinatura para produtos SaaS (Software as a Service) de marketplace comercial a partir de contas de área restrita de integração para habilitar o faturamento.

Observação

Só é possível ativar uma assinatura para produtos SaaS de marketplace 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 instalação.

Pré-requisitos

  • Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
  • Uma conta de parceiro de área restrita de integração com um cliente que tenha uma assinatura ativa para produtos SaaS de marketplace comercial.
  • Para parceiros que usam o SDK do .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 Partner Center .NET foi arquivada. Você pode baixar a versão do SDK no GitHub, juntamente com um arquivo leiame 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 marketplace comercial:

  1. Disponibilize uma interface para as operações de assinatura. 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();

Solicitação REST

Sintaxe da solicitação

Método URI da solicitação
POST {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

Parâmetro do URI

Nome Digitar Obrigatório Descrição
id de locatário do cliente guid Y O valor é um identificador de locatário de cliente formatado por GUID (customer-tenant-id), que permite especificar um cliente.
id da assinatura guid Y O valor é um identificador de assinatura formatado em GUID (subscription-id), que permite especificar uma assinatura.

Cabeçalhos de solicitação

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

Corpo da solicitação

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 REST

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

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira 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"
}