Acompanhar o saldo de crédito Azure no Contrato de Cliente da Microsoft

2025-04-21

Verifique o saldo de crédito Azure de sua conta de cobrança para um Contrato de Cliente da Microsoft no portal do Azure ou por meio de APIs REST.

Na conta de cobrança de um Contrato de Cliente da Microsoft, os créditos são atribuídos a um perfil de cobrança. Cada perfil de cobrança tem créditos próprios, que são aplicados automaticamente aos encargos na respectiva fatura. Você precisa ter uma função de proprietário, colaborador, leitor ou gerenciador de faturas no perfil de cobrança ou uma função de proprietário, colaborador ou leitor na conta de cobrança para exibir o saldo de crédito Azure de um perfil de cobrança. Para saber mais sobre as funções, confira Entender as funções administrativas do Contrato de Cliente da Microsoft no Azure.

Observação

Um novo crédito pode levar até 24 horas para aparecer no portal do Azure. Se você obtiver um novo crédito e não conseguir vê-lo no portal, aguarde 24 horas para ele aparecer.

Este artigo aplica-se a uma conta de cobrança para um Contrato de Cliente da Microsoft. Verifique se você tem acesso a um Contrato de Cliente da Microsoft.

Entre no portal do Azure.
Pesquise Gerenciamento de Custos + Cobrança.
Na página de escopos de cobrança, selecione a conta de cobrança para a qual você deseja acompanhar o saldo de crédito. A conta de cobrança deve ser do tipo Contrato de Cliente da Microsoft.

Observação

O portal do Azure lembra o último escopo do orçamento que você acessou e exibirá o escopo na próxima vez que você visitar a página Gerenciamento de Custos + Cobrança. Você não verá a página de escopos do orçamento se tiver visitado a página de Gerenciamento de Custos + Cobrança anteriormente. Nesse caso, verifique se você está no escopo correto. Caso contrário, alterne o escopo para selecionar a conta de cobrança de um Contrato de Cliente da Microsoft.

Selecione Formas de pagamento do lado esquerdo e, em seguida, selecione Créditos Azure.

Captura de tela que mostra créditos no portal do Azure para Gerenciamento de Custos + Cobrança.

Saldo Disponível

Créditos disponíveis após sua última fatura. Isso inclui apenas todos os créditos ativos e exclui quaisquer créditos expirados ou futuros. Quando o saldo disponível cai para 0, você é cobrado por todo o seu uso, incluindo produtos qualificados para créditos.

Detalhes do crédito

Exibir lista de todos os créditos com detalhes.

Termo	Definição
Fonte	A fonte de aquisição do crédito.
Data de início	A data em que o crédito foi adquirido.
Data de validade	A data em que o crédito expira.
Valor original	O valor original do crédito.
Saldo	O saldo de crédito após a fatura mais recente.
Situação	O status atual do crédito. O status pode ser ativo, usado, expirado ou a expirar

Transações

A seção transações exibe todas as transações que afetaram o seu saldo de crédito.

Captura de tela que mostra transações de crédito no portal do Azure para Gerenciamento de Custos + Cobrança.

Termo	Definição
Data da transação	A data em que a transação aconteceu.
Descrição	Descrição da transação.
Quantidade	A quantidade de transação.

Observação

Se você não vê créditos Azure na página de formas de pagamento, significa que você não tem créditos ou não selecionou o escopo certo. Selecione a conta de cobrança que tem créditos ou um dos respectivos perfis de cobrança. Para saber como alterar os escopos, consulte Alternar os escopos de faturamento no portal do Azure.

Se você estiver exibindo créditos do Azure no escopo da conta de cobrança e a conta de cobrança tiver mais de um perfil de cobrança, a página de créditos do Azure mostrará uma tabela com um resumo dos créditos do Azure para cada perfil de cobrança. Selecione um perfil de cobrança na lista, selecione as formas de pagamento e os créditos Azure para exibir detalhes de um perfil de cobrança.

Use as APIs de Cobrança do Azure e Consumo para obter o saldo de crédito de sua conta de cobrança de forma programática.

Os exemplos mostrados abaixo usam APIs REST. Atualmente, não há suporte para o PowerShell e a CLI do Azure.

Encontrar perfis de cobrança aos quais você tem acesso

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?$expand=billingProfiles&api-version=2019-10-01-preview

A resposta da API retorna uma lista de contas de cobrança e os perfis de cobrança delas.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "name": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "billingProfiles": [
          {
            "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
            "name": "PBFV-xxxx-xxx-xxx",
            "properties": {
              "address": {
                "addressLine1": "AddressLine1",
                "city": "City",
                "companyName": "CompanyName",
                "country": "Country",
                "postalCode": "xxxxx",
                "region": "Region"
              },
              "currency": "USD",
              "displayName": "Development",
              "hasReadAccess": true,
              "invoiceDay": 5,
              "invoiceEmailOptIn": true
            },
            "type": "Microsoft.Billing/billingAccounts/billingProfiles"
          }
        ],
        "displayName": "Contoso",
        "hasReadAccess": true,
      },
      "type": "Microsoft.Billing/billingAccounts"
    }
  ]
}

Use a propriedade displayName do perfil de cobrança para identificar o perfil de cobrança para o qual deseja verificar o saldo de crédito. Copie o id do perfil de cobrança. Por exemplo, caso deseje verificar o saldo de crédito do perfil de cobrança Desenvolvimento, copie /providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx. Cole esse valor em algum lugar, de modo que possa usá-lo na próxima etapa.

Obter a lista de créditos

Faça a solicitação a seguir, substituindo <billingProfileId> pela id copiada na primeira etapa (/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx).

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountId>/billingProfiles/<billingProfileId>/providers/Microsoft.Consumption/lots?api-version=2023-03-01

A resposta à API retorna valores de crédito originais e saldo disponível em todos os lotes de crédito para o perfil de cobrança. Isso inclui créditos ativos, expirados e com uma data de início futura. O saldo disponível pode ser calculado agregando os valores em closedBalance todos os créditos ativos.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx/providers/Microsoft.Consumption/lots/f2ecfd94-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "f2ecfd94-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "Microsoft.Consumption/lots",
      "eTag": null,
      "properties": {
        "originalAmount": {
          "currency": "USD",
          "value": 500.0
        },
        "closedBalance": {
          "currency": "USD",
          "value": 500.0
        },
        "source": "Azure Promotional Credit",
        "startDate": "09/18/2019 21:47:31",
        "expirationDate": "09/18/2020 21:47:30",
        "poNumber": ""
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/xxxx-xxxx-xxx-xxx/providers/Microsoft.Consumption/lots/4ea40eb5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "4ea40eb5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "Microsoft.Consumption/lots",
      "eTag": null,
      "properties": {
        "originalAmount": {
          "currency": "USD",
          "value": 500.0
        },
        "closedBalance": {
          "currency": "USD",
          "value": 497.87
        },
        "source": "Azure Promotional Credit",
        "startDate": "09/18/2019 21:47:31",
        "expirationDate": "09/18/2020 21:47:30",
        "poNumber": ""
      }
    }
  ]
}

Nome do elemento	Descrição
`creditCurrency`	A moeda do crédito.
`billingCurrency`	A moeda usada para cobrança.
`originalAmount`	O valor original do crédito em USD.
`originalAmountInBillingCurrency`	O valor original do crédito na moeda de cobrança com taxa de câmbio.
`expirationDate`	A data em que o crédito expira.
`closedBalance`	O saldo da última fatura em USD.
`closedBalanceInBillingCurrency`	O saldo da última fatura na moeda utilizada na cobrança com taxa de câmbio.
`reseller`	Informações sobre o revendedor, se houver.
`source`	A fonte do crédito, por exemplo, crédito promocional do Azure.
`startDate`	A data em que o crédito se tornou ativo.
`expirationDate`	A data em que o crédito expira.
`poNumber`	O número da ordem de compra da fatura na qual o crédito foi cobrado.
`isEstimatedBalance`	Indica se o saldo é estimado.

Obter as transações que afetaram o saldo de crédito

Faça a solicitação a seguir, substituindo <billingProfileId> pela id copiada na primeira etapa (providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx). Você precisará passar uma startDate e uma endDate para obter transações para o período desejado.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountID>/billingProfiles/<billingProfileID>/providers/Microsoft.Consumption/events?api-version=2023-03-01&startDate=<date>&endDate=<date>

A resposta da API retorna todas as transações que afetaram o saldo de crédito de seu perfil de cobrança.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx`/providers/Microsoft.Consumption/events/e2032eb5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "e2032eb5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "Microsoft.Consumption/events",
      "eTag": null,
      "properties": {
        "transactionDate": "10/11/2019",
        "description": "Credit eligible charges as of 10/11/2019",
        "newCredit": {
          "currency": "USD",
          "value": 0.0
        },
        "adjustments": {
          "currency": "USD",
          "value": 0.0
        },
        "creditExpired": {
          "currency": "USD",
          "value": 0.0
        },
        "charges": {
          "currency": "USD",
          "value": -1.74
        },
        "closedBalance": {
          "currency": "USD",
          "value": 998.26
        },
        "eventType": "PendingCharges",
        "invoiceNumber": ""
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx/providers/Microsoft.Consumption/events/381efd80-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "381efd80-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "Microsoft.Consumption/events",
      "eTag": null,
      "properties": {
        "transactionDate": "09/18/2019",
        "description": "New credit added on 09/18/2019",
        "newCredit": {
          "currency": "USD",
          "value": 500.0
        },
        "adjustments": {
          "currency": "USD",
          "value": 0.0
        },
        "creditExpired": {
          "currency": "USD",
          "value": 0.0
        },
        "charges": {
          "currency": "USD",
          "value": 0.0
        },
        "closedBalance": {
          "currency": "USD",
          "value": 1000.0
        },
        "eventType": "PendingNewCredit",
        "invoiceNumber": ""
      }
    }
  ]
}

Nome do elemento	Descrição
`transactionDate`	A data em que a transação ocorreu.
`description`	A descrição da transação.
`adjustments`	Os ajustes de crédito para a transação.
`creditExpired`	O valor de crédito expirado.
`charges`	Os encargos da transação.
`closedBalance`	O saldo após a transação.
`eventType`	O tipo de transação.
`invoiceNumber`	O número da fatura na qual a transação é cobrada. Ele estará vazio para a transação pendente.

Como os créditos são usados

Em uma conta de cobrança para um Contrato de Cliente da Microsoft, você usa perfis de cobrança para gerenciar suas faturas e suas formas de pagamento. Uma fatura mensal é gerada para cada perfil de cobrança, e você usa as formas de pagamento para pagar a fatura.

Os créditos adquiridos são atribuídos a um perfil de cobrança. Quando uma fatura é gerada para o perfil de cobrança, os créditos são automaticamente aplicados aos encargos totais para calcular o valor que você precisa pagar. Você paga o valor restante com formas de pagamento como cheque/transferência eletrônica ou cartão de crédito.

Produtos que não são cobertos pelos créditos Azure

Os produtos a seguir não são cobertos pelos créditos Azure. Você é cobrado por usar esses produtos, independentemente de seu saldo de crédito:

Canônico
Citrix XenApp Essentials
Citrix XenDesktop
Usuário registrado
OpenLogic
Direitos de Acesso Remoto XenApp EssentialsUsuário Registrado
Vantagem do Ubuntu
Visual Studio Enterprise (mensal)
Visual Studio Enterprise (anual)
Visual Studio Professional (mensal)
Visual Studio Professional (anual)
Produtos do Azure Marketplace
Planos de Suporte do Azure

Verificar o acesso ao Contrato de Cliente da Microsoft

Para verificar o tipo de contrato e determinar se você tem acesso a uma conta de cobrança para um Contrato de Cliente da Microsoft, siga estas etapas:

Vá para o portal do Azure para conferir o acesso à conta de cobrança. Pesquise e selecione Gerenciamento de Custos + Cobrança.
Caso você tenha acesso a apenas um escopo de cobrança, selecione Propriedades no menu. Você tem acesso a uma conta de cobrança para um Contrato de Cliente da Microsoft se o tipo de conta de cobrança é Contrato de Cliente da Microsoft.

Caso tenha acesso a vários escopos de cobrança, verifique o tipo na coluna da conta de cobrança. Você tem acesso a uma conta de cobrança para um Contrato de Cliente da Microsoft se o tipo de conta de cobrança para um dos escopos é Contrato de Cliente da Microsoft.

Precisa de ajuda? Entre em contato com o suporte.

Se precisar de ajuda, contate o suporte para resolver seu problema rapidamente.