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

Artigo
03/14/2024

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:

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);
```

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/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 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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

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

Compartilhar via