|
1 | 1 | ---
|
2 |
| -title: PAYG billing for SharePoint Embedded |
3 |
| -description: This article explains the billing models and how to set up PAYG billing. |
4 |
| -ms.date: 03/03/2025 |
| 2 | +title: Pay-as-you-go billing for SharePoint Embedded |
| 3 | +description: This article explains the billing models and how to set up pay-as-you-go billing. |
| 4 | +ms.date: 08/13/2025 |
5 | 5 | ms.localizationpriority: high
|
6 | 6 | ---
|
7 | 7 |
|
8 | 8 | # SharePoint Embedded billing
|
9 | 9 |
|
10 |
| -SharePoint Embedded is a consumption-based Pay-as-you-go (PAYG) offering meaning you pay only for what you use. SharePoint Embedded provides two billing models that the tenant developing the SharePoint Embedded application can select for respective container types, tailoring it to their unique business requirements. The two billing models are Standard and Pass-through billing. |
| 10 | +SharePoint Embedded is a consumption-based pay-as-you-go offering meaning you pay only for what you use. SharePoint Embedded provides two billing models that the tenant developing the SharePoint Embedded application can select for respective container types, tailoring it to their unique business requirements. The two billing models are Standard and Passthrough billing. |
11 | 11 |
|
12 |
| -### Standard |
| 12 | +## Standard billing |
13 | 13 |
|
14 | 14 | With the standard billing model, all consumption-based charges are directly billed to the tenant who owns or develops the application. The admin in the developer tenant must establish a valid billing profile when creating a standard container type.
|
15 | 15 |
|
16 |
| - |
| 16 | + |
17 | 17 |
|
18 |
| -### Pass-through |
| 18 | +## Passthrough billing |
19 | 19 |
|
20 |
| -With pass-through billing, consumption-based charges are billed directly to the tenant registered to use the SharePoint Embedded application. Admins in the developer tenant don't need to set up a billing profile when creating a pass-through SharePoint Embedded container type. Once the container type is registered in the consuming tenant, the consuming tenant admin (SharePoint Admin or Global Admin) needs to set up the billing profile in the consuming tenant to use the SharePoint Embedded application. |
| 20 | +With passthrough billing, consumption-based charges are billed directly to the tenant registered to use the SharePoint Embedded application. Admins in the developer tenant don't need to set up a billing profile when creating a passthrough SharePoint Embedded container type. Once the container type is registered in the consuming tenant, the consuming tenant admin (SharePoint Admin or Global Admin) needs to set up the billing profile in the consuming tenant to use the SharePoint Embedded application. |
21 | 21 |
|
22 |
| - |
| 22 | + |
23 | 23 |
|
24 |
| -## Prerequisites to create SharePoint Embedded container type |
| 24 | +## Create a SharePoint Embedded container type |
25 | 25 |
|
26 |
| -A new container type will be created using **SharePoint Online Management Shell**: |
| 26 | +For information on how to create a container type with billing enabled, see [creating a container type](../../getting-started/containertypes.md#creating-container-types). |
27 | 27 |
|
28 |
| -1. Download and install the [latest version of SharePoint Online Management Shell](https://www.microsoft.com/download/details.aspx?id=35588) |
29 |
| -1. Open SharePoint Online Management Shell from **Start** screen, type **sharepoint**, and then select **SharePoint Online Management Shell**. |
30 |
| -1. Connect to SPO service using `Connect-SPOService` cmdlet by providing admin credentials associated with tenancy. For information on [how to use Connect-SPOService](/powershell/module/sharepoint-online/connect-sposervice), refer the linked documentation. |
| 28 | +## View & edit billing properties of standard container type |
31 | 29 |
|
32 |
| -### Tenant requirements |
| 30 | +You can view the properties of a container type and associated billing properties by using the Container Type APIs: |
33 | 31 |
|
34 |
| -- An active instance of SharePoint is required in your Microsoft 365 tenant. |
35 |
| -- Users who will be authenticating into SharePoint Embedded Container Types and Containers must be in Entra ID (Members and Guests) |
| 32 | +- [List container types](/graph/api/filestorage-list-containertypes) |
| 33 | +- [Get container type](/graph/api/filestoragecontainertype-get) |
36 | 34 |
|
37 |
| - > [!NOTE] |
38 |
| - > An Office license is not required to collaborate on Microsoft Office documents stored in a container. |
| 35 | +To update the billing properties on a container type with standard billing, see [set the billing profile](../../getting-started/containertypes.md#set-the-billing-profile). |
39 | 36 |
|
40 |
| -### Roles and Permissions |
| 37 | +## Set up billing for passthrough container types in consuming tenant |
41 | 38 |
|
42 |
| -- The admin who sets up the billing relationship for SharePoint Embedded needs to have owner or contributor permissions on the Azure subscription. |
43 |
| -- Admin needs to have a SharePoint Embedded Administrator or Global Admin role to operate billing cmdlets. |
44 |
| - |
45 |
| -### Azure Subscription |
46 |
| - |
47 |
| -For the Standard Billing container type, the developer admin needs to set up: |
48 |
| - |
49 |
| -- An existing SharePoint tenancy |
50 |
| -- An Azure subscription in the tenancy |
51 |
| -- A resource group attached to the Azure subscription |
52 |
| - |
53 |
| -## Set up a Standard Billing container type |
54 |
| - |
55 |
| -For standard billed container types, developer admins should set up billing in their tenant. The Microsoft 365 SharePoint Embedded Administrator serves as the developer admin. Global Administrators in Microsoft 365 can assign users the SharePoint Embedded Administrator role, which already has all the permissions of the SharePoint Embedded Administrator role. The SharePoint Embedded Admin role is available in Microsoft Entra and Microsoft 365 Admin Center. |
56 |
| - |
57 |
| -SharePoint Embedded Admin can create a container type using the `New-SPOContainerType` cmdlet by providing an Azure subscription, the resource group associated with the subscription, and a region. |
58 |
| - |
59 |
| -- If you don't have an Azure subscription, you can create one by following the steps here to [create an Azure subscription in your tenancy](/azure/cloud-adoption-framework/ready/azure-best-practices/initial-subscriptions), |
60 |
| -- If you don't have a resource group, you can create one by following the steps here to [create a resource group](/azure/azure-resource-manager/management/manage-resource-groups-portal) |
61 |
| - |
62 |
| -```powershell |
63 |
| -New-SPOContainerType -ContainerTypeName <ContainerTypeName> |
64 |
| - -OwningApplicationId <OwningApplicationId> |
65 |
| - -AzureSubscriptionId <AzureSubscriptionId> |
66 |
| - -ResourceGroup <ResourceGroup> |
67 |
| - -Region <Region> |
68 |
| -``` |
69 |
| - |
70 |
| -> [!IMPORTANT] |
71 |
| -> Every container type must have an owning application. |
72 |
| -> |
73 |
| -> A single-owning app can only own one container type at a time. |
74 |
| -> |
75 |
| -> An Azure subscription can be attached to any number of container types. |
76 |
| -
|
77 |
| -### View & Edit billing properties of Standard container type |
78 |
| - |
79 |
| -You can view the properties of a container type and associated billing properties by using one of the two PowerShell cmdlets: |
80 |
| - |
81 |
| -1. See all container types and billing properties except associated region: |
82 |
| - |
83 |
| - ```powershell |
84 |
| - Get-SPOContainerType |
85 |
| - ``` |
86 |
| -
|
87 |
| -1. See billing properties associated with a container type including region: |
88 |
| -
|
89 |
| - ```powershell |
90 |
| - Get-SPOContainerType -ContainerTypeId <ContainerTypeId> |
91 |
| - ``` |
92 |
| -
|
93 |
| -1. Update Azure subscription or resource group associated with a container type: |
94 |
| -
|
95 |
| - ```powershell |
96 |
| - Set-SPOContainerType -ContainerTypeId <ContainerTypeId> [-AzureSubscriptionId <AzureSubscriptionId>] [-ResourceGroup <ResourceGroup>] |
97 |
| - ``` |
98 |
| -
|
99 |
| -
|
100 |
| -## Set up a Pass-through Billing container type |
101 |
| -
|
102 |
| -For Pass-through Billing container types, the developer admin doesn't have to set up billing in the developer tenant. SharePoint Embedded Admin can create container type using `New-SPOContainerType` cmdlet with `isPassThroughBilling` specified. |
103 |
| -
|
104 |
| -```powershell |
105 |
| -New-SPOContainerType -ContainerTypeName <ContainerTypeName> |
106 |
| - -OwningApplicationId <OwningApplicationId> |
107 |
| - -isPassThroughBilling |
108 |
| -``` |
109 |
| - |
110 |
| -### [Set Up Guide in Consuming Tenant Admin Center](../consuming-tenant-admin/cta.md#set-up-billing-for-pass-through-app) |
111 |
| - |
112 |
| -1. In [Microsoft 365 admin center](https://admin.microsoft.com/), select **Setup**, and the view the **Files and Content** section. Select **Automate Content with Microsoft Syntex.** |
113 |
| - |
114 |
| -  |
115 |
| - |
116 |
| -1. Select **Go to Syntex settings**. |
117 |
| -1. Select **Apps** under **Syntex services for**, select **SharePoint Embedded** |
118 |
| - |
119 |
| -  |
120 |
| - |
121 |
| -1. Follow the instructions on the **SharePoint Embedded** flyer to turn on SharePoint Embedded apps. |
| 39 | +To set up billing for a passthrough container type in the consuming tenant, see the [setup guide in the consuming tenant Admin Center](../consuming-tenant-admin/cta.md#set-up-billing-for-passthrough-app). |
122 | 40 |
|
123 | 41 | ## SharePoint Embedded meters
|
124 | 42 |
|
|
0 commit comments