| You have | It is | Where it appears |
|---|---|---|
| SaaS subscription id | The {subscriptionId} in every subscription URL | GET /subscriptions → MarketplaceSubscriptionId; /financials → AssetId; /usage → ReferenceId |
Partner Center dimension id (for example transaction_tier_1) | The dimensionId you charge with | GET /subscriptions?includeMeters=true → MeteringDetails.Meters[].MeterId and PartnerCenterMeterId (same value); /usage → MeterId |
| Customer's Azure subscription | Microsoft's own MarketplaceSubscriptionId column in the usage report | /usage → MarketplaceSubscriptionId. Not the SaaS subscription id |
| Purchase line | One line of one purchase | /financials → PurchaseRecordId + LineItemId. Two orders can share one AssetId |
Start every integration with GET /api/v1.0/subscriptions?includeMeters=true. It lists only subscriptions whose plan has metered dimensions, with the dimension ids to charge and a charge link per subscription.