You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -31,66 +31,61 @@ This article applies to a billing account for a Microsoft Customer Agreement. [C
31
31
32
32
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/billing-search-cost-management-billing.png" alt-text="Screenshot that shows search in the Azure portal for Cost Management + Billing.":::
33
33
34
-
3. In the billing scopes page, select the billing account for which you want to track the credit balance. The billing account should be of type **Microsoft Customer Agreement**.
34
+
1. In the billing scopes page, select the billing account for which you want to track the credit balance. The billing account should be of type **Microsoft Customer Agreement**.
35
35
36
-
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/list-of-scopes.png" alt-text="Screenshot that shows Billing Scopes.":::
36
+
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/list-of-scopes.png" alt-text="Screenshot that shows billing scopes in Cost Management + Billing.":::
37
37
38
-
> [!NOTE]
39
-
>
40
-
> Azure portal remembers the last billing scope that you access and displays the scope the next time you come to Cost Management + Billing page. You won't see the billing scopes page if you have visited Cost Management + Billing earlier. If so, check that you are in the [right scope](#check-access-to-a-microsoft-customer-agreement). If not, [switch the scope](view-all-accounts.md#switch-billing-scope-in-the-azure-portal) to select the billing account for a Microsoft Customer Agreement.
38
+
39
+
> [!NOTE]
40
+
> Azure portal remembers the last billing scope that you access and displays the scope the next time you come to Cost Management + Billing page. You won't see the billing scopes page if you have visited Cost Management + Billing earlier. If so, check that you are in the **[right scope](/azure/cost-management-billing/manage/mca-check-azure-credits-balance?tabs=portal)**. If not, **[switch the scope](/azure/cost-management-billing/manage/view-all-accounts)** to select the billing account for a Microsoft Customer Agreement.
41
+
42
+
43
+
44
+
45
+
1. Select **Payment methods** from the left-hand side and then select **Azure credits**.
41
46
42
-
3. Select **Payment methods** from the left-hand side and then select **Azure credits**.
43
47
44
-
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/mca-payment-methods.png" alt-text="Screenshot of estimated and current balances.":::
48
+
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/azure-credits-page-azportal.png" alt-text="Screenshot that shows Credits in the Azure portal for Cost Management + Billing.":::
49
+
50
+
51
+
52
+
#### Available Balance
45
53
46
-
4. The Azure credits page has the following sections:
47
-
48
-
#### Balance
49
-
50
-
The balance section displays the summary of your Azure credit balance.
51
-
52
-
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/mca-credit-balance.png" alt-text="Screenshot showing the credit balance for a billing profile.":::
| Estimated balance | Estimated amount of credits you have after considering all billed and pending transactions |
57
-
| Current balance | Amount of credits as of your last invoice. It doesn't include any pending transactions |
58
-
59
-
When your estimated balance drops to 0, you are charged for all your usage, including for products that are eligible for credits.
60
-
61
-
#### Credits list
62
-
63
-
The credits list section displays the list of Azure credits.
64
-
65
-
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/mca-credits-list.png" alt-text="Screenshot showing the credits lists for a billing profile.":::
54
+
Available credits after your last invoice. This includes all active credits only and excludes any expired or future credits. When your available balance drops to 0, you are charged for all your usage, including products that are eligible for credits.
55
+
56
+
#### Credit details
66
57
58
+
View list of all credits with details.
59
+
67
60
| Term | Definition |
68
61
|---|---|
69
-
| Source | The acquisition source of the credit |
70
-
| Start date | The date when you acquired the credit |
71
-
| Expiration date | The date when the credit expires |
72
-
| Current balance | The balance as of your last invoice |
73
-
| Original amount | The original amount of credit |
74
-
| Status | The current status of credit. Status can be active, used, expired, or expiring |
75
-
76
-
#### Transactions
77
-
78
-
The transactions section displays all transactions that affected your credits balance.
79
-
80
-
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/mca-credits-transactions.png" alt-text="Screenshot showing credit transactions for a billing profile.":::
81
-
62
+
| Source |The acquisition source of the credit.|
63
+
| Start date |The date when credit was acquired.|
64
+
| Expiration date |The date when the credit expires.|
65
+
| Original amount|The original amount of the credit.|
66
+
| Balance|The credit balance after the latest invoice.|
67
+
| Status |The current status of credit. Status can be active, used, expired, or expiring |
68
+
69
+
70
+
#### Transactions
71
+
72
+
The transactions section displays all transactions that affected your credits balance.
73
+
74
+
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/credits-transactions-azportal.png" alt-text="Screenshot that shows Credit transactions in the Azure portal for Cost Management + Billing.":::
75
+
82
76
| Term | Definition |
83
77
|---|---|
84
-
| Transaction date | The date when the transaction happened |
85
-
| Description | A description of the transaction |
86
-
| Amount| The amount of transaction |
87
-
| Balance | The balance after the transaction |
88
-
89
-
> [!NOTE]
90
-
>
91
-
> If you don't see Azure credits in the payment methods page, either you don't have credits or you have not selected the right scope. Select the billing account which has credits or one of its billing profiles. To learn how to change scopes, see [Switch billing scopes in the Azure portal](view-all-accounts.md#switch-billing-scope-in-the-azure-portal).
92
-
93
-
5. If you are viewing Azure credits at the billing account scope and the billing account has more than one billing profiles, the Azure credits page will show a table with a summary of Azure credits for each billing profile. Select a billing profile from the list, select payment methods and then Azure credits to view details for a billing profile.
78
+
| Transaction date |The date when the transaction happened.|
79
+
| Description |Description of the transaction.|
80
+
| Amount |The amount of transaction.|
81
+
82
+
> [!NOTE]
83
+
> If you don't see Azure credits in the payment methods page, either you don't have credits or you have not selected the right scope. Select the billing account which has credits or one of its billing profiles. To learn how to change scopes, see [Switch billing scopes in the Azure portal](view-all-accounts.md#switch-billing-scope-in-the-azure-portal).
84
+
85
+
86
+
87
+
88
+
1. If you are viewing Azure credits at the billing account scope and the billing account has more than one billing profiles, the Azure credits page will show a table with a summary of Azure credits for each billing profile. Select a billing profile from the list, select payment methods and then Azure credits to view details for a billing profile.
94
89
95
90
:::image type="content" border="true" source="./media/mca-check-azure-credits-balance/mca-account-credit-list.png" alt-text="Screenshot showing the credit list for a billing account.":::
96
91
@@ -151,65 +146,14 @@ The API response returns a list of billing accounts and their billing profiles.
151
146
152
147
Use the `displayName` property of the billing profile to identify the billing profile for which you want to check the credit balance. Copy the `id` of the billing profile. For example, if you want to check credit balance for **Development** billing profile, you'd copy ```/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx```. Paste this value somewhere so that you can use it in the next step.
153
148
154
-
### Get Azure credit balance
155
-
156
-
Make the following request, replacing `<billingProfileId>` with the `id` copied in the first step (```/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx```).
157
-
158
-
```json
159
-
GET https://management.azure.com<billingProfileId>/providers/Microsoft.Consumption/credits/balanceSummary?api-version=2019-10-01
160
-
```
161
-
162
-
The API response returns estimated and current balance for the billing profile.
|`estimatedBalance`| The estimated amount of credits you have after considering all billed and pending transactions. |
200
-
|`currentBalance`| The amount of credits as of your last invoice. It doesn't include any pending transactions. |
201
-
|`pendingCreditAdjustments`| The adjustments like refunds that are not yet invoiced. |
202
-
|`expiredCredit`| The credit that expired since your last invoice. |
203
-
|`pendingEligibleCharges`| The credit eligible charges that are not yet invoiced. |
204
-
205
149
### Get list of credits
206
150
207
151
Make the following request, replacing `<billingProfileId>` with the `id` copied in the first step (```/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx```).
208
152
209
153
```json
210
-
GET https://management.azure.com<billingProfileId>/providers/Microsoft.Consumption/lots?api-version=2019-10-01
154
+
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountId>/billingProfiles/<billingProfileId>/providers/Microsoft.Consumption/lots?api-version=2023-03-01
211
155
```
212
-
The API response returns lists of Azure credits for a billing profile.
156
+
The API response returns original credit amounts and available balance across all credit lots for the billing profile. This includes active, expired, and credits with a future start date. Available balance can be computed by aggregating the values in `closedBalance` across all active credits.
213
157
214
158
```json
215
159
{
@@ -259,19 +203,26 @@ The API response returns lists of Azure credits for a billing profile.
|`originalAmount`| The original amount of the credit. |
263
-
|`closedBalance`| The balance as of the last invoice. |
264
-
|`source`| The source that defines who how acquired the credit. |
265
-
|`startDate`| The date when the credit became active. |
266
-
|`expirationDate`| The date when the credit expires. |
267
-
|`poNumber`| The purchase order number of the invoice on which the credit was billed. |
206
+
|`creditCurrency`|The currency of the credit. |
207
+
|`billingCurrency`|The currency used for billing. |
208
+
|`originalAmount`|The original amount of the credit in USD. |
209
+
|`originalAmountInBillingCurrency`| The original amount of the credit in billing currency with exchange rate. |
210
+
|`expirationDate`|The date when the credit expires. |
211
+
|`closedBalance`|The balance as of the last invoice in USD. |
212
+
|`closedBalanceInBillingCurrency`|The balance as of the last invoice in billing currency with exchange rate. |
213
+
|`reseller`|Information about the reseller, if any. |
214
+
|`source`|The source of the credit, e.g., Azure promotional credit. |
215
+
|`startDate`|The date when the credit became active. |
216
+
|`expirationDate`|The date when the credit expires. |
217
+
|`poNumber`|The purchase order number of the invoice on which the credit was billed. |
218
+
|`isEstimatedBalance`|Indicates whether the balance is estimated. |
268
219
269
220
### Get transactions that affected credit balance
270
221
271
222
Make the following request, replacing `<billingProfileId>` with the `id` copied in the first step (```providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx```). You would need to pass a **startDate** and an **endDate** to get transactions for your required duration.
272
223
273
224
```json
274
-
GET https://management.azure.com<billingProfileId>/providers/Microsoft.Consumption/events?api-version=2019-10-01&startDate=2018-10-01T00:00:00.000Z&endDate=2019-10-11T12:00:00.000Z?api-version=2019-10-01
225
+
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>
275
226
```
276
227
The API response returns all transactions that affected the credit balance for your billing profile.
277
228
@@ -360,9 +311,9 @@ The API response returns all transactions that affected the credit balance for y
360
311
361
312
## How credits are used
362
313
363
-
In a billing account for a Microsoft customer agreement, you use billing profiles to manage your invoices and payment methods. A monthly invoice is generated for each billing profile and you use the payment methods to pay the invoice.
314
+
In a billing account for a Microsoft customer agreement, you use billing profiles to manage your invoices and payment methods. A monthly invoice is generated for each billing profile, and you use the payment methods to pay the invoice.
364
315
365
-
You assign credits that you acquire to a billing profile. When an invoice is generated for the billing profile, credits are automatically applied to the total charges to calculate the amount that you need to pay. You pay the remaining amount with your payment methods like check/ wire transfer or credit card.
316
+
Credits that you acquire are assigned to a billing profile. When an invoice is generated for the billing profile, credits are automatically applied to the total charges to calculate the amount that you need to pay. You pay the remaining amount with your payment methods like check/ wire transfer or credit card.
366
317
367
318
## Products that aren't covered by Azure credits
368
319
@@ -392,4 +343,6 @@ If you need help, [contact support](https://portal.azure.com/?#blade/Microsoft_A
392
343
## Next steps
393
344
394
345
-[Understand billing account for Microsoft Customer Agreement](../understand/mca-overview.md)
346
+
395
347
-[Understand terms on your Microsoft Customer Agreement invoice](../understand/mca-understand-your-invoice.md)
0 commit comments