> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt # Manage Billing Billing settings are configured at the organization level and apply to all projects within that organization. You can examine costs at the organization level or the project level. Atlas: - charges by the hour for your MongoDB clusters - charges for usage of your MongoDB Flex clusters - tabulates costs daily - displays your current monthly costs on the [Invoices page](https://www.mongodb.com/docs/atlas/billing/invoices.md#std-label-view-current-invoice) To view line-item charges, [view all of your invoices.](https://www.mongodb.com/docs/atlas/billing/invoices.md#std-label-view-past-invoices) To consume your billing data programmatically in an industry-standard format, see [Access the FOCUS Cost and Usage Report.](https://www.mongodb.com/docs/atlas/billing/focus-report.md#std-label-focus-report-overview) As you configure a cluster, you can view the total cost, except for data transfer, before applying your settings. ## Required Access - To view billing information, you must have [`Organization Billing Viewer`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Billing-Viewer) access or higher. - To configure billing settings, such as the payment method and billing profile, you must have [`Organization Owner`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Owner) or [`Organization Billing Admin`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Billing-Admin) access. ## Access Billing To configure the payment method and billing profile for an organization, or to view the most recent and pending charges for an organization: 1. In Atlas, go to the Billing page for your organization. If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar. In the sidebar, click Overview under the Billing header. The [Billing](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2Foverview) page displays. 2. Review billing. ## Your Billing Profile Your billing profile stores your organization's invoice address, which Atlas uses for tax calculation and displays on your invoices. The billing address in the [payment method](https://www.mongodb.com/docs/atlas/billing.md#std-label-atlas-payment-method) section is a separate address tied to your payment method. When you first add a payment method, Atlas copies the billing address to use as the invoice address. You can update the invoice address at any time. ### View and Edit Your Billing Profile To view and edit your billing profile: 1. In Atlas, go to the Billing page for your organization. If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar. In the sidebar, click Overview under the Billing header. The [Billing](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2Foverview) page displays. 2. Review the Overview page. In the Overview page, you can explore: - Invoice information that includes a Pending Invoice section, which shows your Net Month-to-Date Amount for the current billing period. The net month-to-date amount reflects your net charges from the start of the period to the current day. You can also see a Last Invoice section, which shows your usage and amount due for the previous billing period. - The [billing cost visualization charts.](https://www.mongodb.com/docs/atlas/billing.md#std-label-billing-visualizations) - The [Available Credits](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-subscription-level) and [History](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-subscription-level) sections. 3. Click Edit in the Payment Method card. 4. Update your Invoice Address details as needed. | Field | Necessity | Action | | --- | --- | --- | | Billing Email Address | Optional | Type the email address to which Atlas should send [billing alerts.](https://www.mongodb.com/docs/atlas/reference/alert-conditions.md#std-label-billing-alerts) By default, Atlas sends billing alerts to the Organization Owners and Billing Admins. If you leave the Billing Email Address blank, Atlas sends billing alerts to the Organization Owners and Billing Admins.; If you specify a billing email address and uncheck Only send invoice emails to the Billing Email Address, Atlas sends billing alerts to the billing email address, Organization Owners, and Billing Admins.; If you specify a billing email address and check the box for Only send invoice emails to the Billing Email Address, Atlas send billing alerts to the billing email address only. | | Company Name | Optional | Type the name of the company for your invoice address. | | Country | Required | Select the country for your invoice address. You can also start typing the name of the country and then select it from the filtered list of countries. | | Address Line 1 | Required | Type the mailing address for your invoice address. | | Address Line 2 | Optional | Type an additional line for the mailing address for your invoice address. | | City | Required | Type the name of the city for your invoice address. | | State/Province/Region | Required | Type or select the political subdivision in which your invoice address exists. The label and field change depending on what you selected as your **Country**: If you select **United States** as your **Country**, this label changes to **State**. The field changes to a dropdown menu of U.S. states. You can also start typing the name of the state and then select it from the filtered list of states.; If you select **Canada** as your **Country**, this label changes to **Province**. The field changes to a dropdown menu of Canadian provinces. You can also start typing the name of the province and then select it from the filtered list of provinces.; If you select any other country as your **Country**, this label changes to **State/Province/Region**. The field changes to a text box. Type the name of your province, state, or region in this box. | | ZIP or Postal Code | Required | Type the ZIP (U.S.) or Postal Code (other countries) for your invoice address. | | VAT Number | Conditional | Atlas displays the VAT ID field if you select a country other than the United States. To learn more about VAT, see [VAT ID.](https://www.mongodb.com/docs/atlas/billing/international-usage.md#std-label-vat-id-number) If your company's billing address is in a country other than the United States (USA), Atlas typically charges VAT (Value Added Tax) if you do not enter a valid `VAT ID Number` on your [billing profile.](https://www.mongodb.com/docs/atlas/billing.md#std-label-atlas-billing-profile) IMPORTANT: If your billing address is in Ireland or certain Canadian provinces, Atlas always charges VAT (Value Added Tax), even with a valid `VAT ID Number`. To learn more about VAT (Value Added Tax) by region, see [International Usage and Taxation.](https://www.mongodb.com/docs/atlas/billing/international-usage.md#std-label-atlas-international-tax) | 5. Accept or decline your changes. - To accept your changes, click Submit. - To decline your changes, click Cancel. ## Payment Method To pay for your Atlas usage, you can: - Pay with an [accepted payment method.](https://www.mongodb.com/docs/atlas/billing.md#std-label-payment-alternatives) - Pay with a MongoDB Atlas [subscription.](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-atlas-subscriptions) To purchase a subscription, you can contact [MongoDB Sales](https://www.mongodb.com/company/contact?tck=docs) or purchase one through a marketplace. Your [subscription level](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-subscription-level) determines your access to support and other entitlements. Contact [MongoDB Sales](https://www.mongodb.com/company/contact?tck=docs) to review alternative billing methods. **Important:** To confirm your card information, Atlas charges $1.00 when you first connect a card to your account. After Atlas confirms your information, it refunds the $1.00 charge. If you encounter any issues connecting a card to your account, contact your card provider or banking institution. Verify whether they declined the initial charge, which would prevent Atlas from confirming your information. Under certain conditions, MongoDB seeks pre-authorization to cover the charges of your selected infrastructure. ### Set Payment Method MongoDB accepts the following payment methods through the Atlas console: - Card - Google Pay (not available in India) - US bank account (US only) - SEPA Direct Debit (EEA only) - Revolut Pay (UK and EEA only) - Link - PayPal To set your payment method: 1. In Atlas, go to the Billing page for your organization. If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar. In the sidebar, click Overview under the Billing header. The [Billing](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2Foverview) page displays. 2. Review the Overview page. In the Overview page, you can explore: - Invoice information that includes a Pending Invoice section, which shows your Net Month-to-Date Amount for the current billing period. The net month-to-date amount reflects your net charges from the start of the period to the current day. You can also see a Last Invoice section, which shows your usage and amount due for the previous billing period. - The [billing cost visualization charts.](https://www.mongodb.com/docs/atlas/billing.md#std-label-billing-visualizations) - The [Available Credits](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-subscription-level) and [History](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-subscription-level) sections. 3. Click Edit in the Payment Method card. 4. Update your Billing Address details as needed. | Field | Necessity | Action | | --- | --- | --- | | Full name | Required | Type the full name associated with your billing address. | | Country | Required | Select the country for your billing address. You can also start typing the name of the country and then select it from the filtered list of countries. | | VAT ID | Conditional | Atlas displays the VAT ID field if you select a country other than the United States. To learn more about VAT, see [VAT ID.](https://www.mongodb.com/docs/atlas/billing/international-usage.md#std-label-vat-id-number) If your company's billing address is in a country other than the United States (USA), Atlas typically charges VAT (Value Added Tax) if you do not enter a valid `VAT ID Number` on your [billing profile.](https://www.mongodb.com/docs/atlas/billing.md#std-label-atlas-billing-profile) IMPORTANT: If your billing address is in Ireland or certain Canadian provinces, Atlas always charges VAT (Value Added Tax), even with a valid `VAT ID Number`. To learn more about VAT (Value Added Tax) by region, see [International Usage and Taxation.](https://www.mongodb.com/docs/atlas/billing/international-usage.md#std-label-atlas-international-tax) | | Address | Required | Type the street address for your billing address. | | Apt, suite, etc. | Optional | Type the apartment, suite, or floor number for your billing address. | | City | Required | Type the name of the city for your billing address. | | State/Province/Region | Required | Type or select the political subdivision in which your billing address exists. The label and field change depending on what you selected as your **Country**: If you select **United States** as your **Country**, this label changes to **State**. The field changes to a dropdown menu of U.S. states. You can also start typing the name of the state and then select it from the filtered list of states.; If you select **Canada** as your **Country**, this label changes to **Province**. The field changes to a dropdown menu of Canadian provinces. You can also start typing the name of the province and then select it from the filtered list of provinces.; If you select any other country as your **Country**, this label changes to **State/Province/Region**. The field changes to a text box. Type the name of your province, state, or region in this box. | | ZIP or Postal Code | Required | Type the ZIP (U.S.) or Postal Code (other countries) for your billing address. | 5. Select your Payment Method. In the Payment Method section, select one of the following options: - If you select Card, enter the following details: | Field | Necessity | Action | | --- | --- | --- | | Card Number | Required | Type your card number. | | Expiration Date | Required | Type your card's expiration date in MM/YY format. | | CVC (Card Verification Code) | Required | Type the three-digit security code for your card. For American Express, the security code is the 4-digit long code on the front of the card. | - If you select Google Pay, follow the on-screen instructions to complete the payment setup. Google Pay is not available in India. - If you select US bank account, follow the on-screen instructions to connect your bank account. This option is available only in the United States. - If you select SEPA Direct Debit, enter your account details. This option is available only in the EEA. SEPA Direct Debit charges are processed in EUR. - If you select Revolut Pay, an additional step appears to securely submit your payment information. This option is available only in the UK and EEA. Revolut Pay charges are processed in EUR. - If you select Link, follow the on-screen prompts to complete the payment setup. - If you select PayPal: Click Pay with PayPal. Complete the actions on the PayPal website. **Note:** All projects within your organization share the same billing settings, including payment method. 6. Save your payment method. - To save your changes, click Save Payment Method. - To discard your changes, click Cancel. Through [MongoDB Sales](https://www.mongodb.com/company/contact?tck=docs), you can pay using a: - Currency other than USD (United States Dollars). - Method not available in the Atlas console. ### Retry a Failed Payment To retry a failed payment: 1. In Atlas, go to the Billing page for your organization. If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar. In the sidebar, click Overview under the Billing header. The [Billing](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2Foverview) page displays. 2. Review the Overview page. In the Overview page, you can explore: - Invoice information that includes a Pending Invoice section, which shows your Net Month-to-Date Amount for the current billing period. The net month-to-date amount reflects your net charges from the start of the period to the current day. You can also see a Last Invoice section, which shows your usage and amount due for the previous billing period. - The [billing cost visualization charts.](https://www.mongodb.com/docs/atlas/billing.md#std-label-billing-visualizations) - The [Available Credits](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-subscription-level) and [History](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-subscription-level) sections. 3. Verify your Payment Method. View the payment method displayed in the Payment Method card. If this method appears incorrect, click Edit in that card. 4. Filter your list of invoices, if desired. You can filter the invoices by status and date. - To filter by status, click the Status drop-down and select the status to which you want to limit the results: | Status | Invoice Type | | --- | --- | | Pending | Invoices still pending payment. | | Free | Invoices with a total charge of `$0.00`. | | Successful | Invoices that are paid. | - To filter by invoice date, set the From or To date inputs to the required date range. - If you leave From blank, Atlas sets the lower date boundary to the organization's creation date. - If you leave To blank, Atlas sets the upper date boundary to the current date. 5. Open your invoice to see its payment details. To open a specific invoice, click its link in Invoice Date or Invoice Period. The invoice page shows the following sections: | Invoice Section | Contents | | --- | --- | | Invoice header card | The invoice amount due, the total cost of your usage for the billing period, and your billing information. In this card, you can download the invoice as a PDF or CSV usage summary, or as a CSV FOCUS cost and usage report. If you use credits, you can also see your total credit usage and the credit unit price. | | Payment Details | Payments that are itemized by the payment method. The table lists: [Payment methods](https://www.mongodb.com/docs/atlas/billing.md#std-label-atlas-billing-methods), which may include Atlas credits from a prepaid subscription or promotional subscription, a [monthly commitment subscription](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-subscription-types), a marketplace subscription, a credit card, or PayPal.; Date: the date when Atlas issued the charge.; [Payment status.](https://www.mongodb.com/docs/atlas/billing/invoices.md#std-label-payment-statuses); Usage: the dollar or credit amount you have used.; Billed Usage: the amount you are being billed for. Billed Usage amount can differ from the usage amount in a number of cases, such as when a month's usage is below the monthly minimum on your Atlas subscription, or a month's billed usage encompasses usage for multiple months.; Total Cost: the unit price multiplied by billed usage, plus taxes. Taxes represent the amount of taxes collected by MongoDB. If you have a marketplace subscription, taxes are imposed by your Cloud Provider. To learn more, see [Taxation by Region.](https://www.mongodb.com/docs/atlas/billing/international-usage.md#std-label-atlas-international-tax); Amount Due.; Action that you can click. Actions can be one of the following:PDF: download the PDF of the tax invoice that you receive by email.; VIEW DETAILS: view your subscription's monthly commitment details.; PAY NOW: pay your bill directly if you are a YayPay customer.; RETRY: [retry the failed payment.](https://www.mongodb.com/docs/atlas/billing.md#std-label-retry-failed-payment) To learn more, see [Payment and Usage Details.](https://www.mongodb.com/docs/atlas/billing/invoices.md#std-label-payment-details) | | Total Usage chart | The total usage by your Atlas usage over the billing period. You can filter usage by service. To learn more, see [Invoice Charts.](https://www.mongodb.com/docs/atlas/billing.md#std-label-invoice-charts) | | By Deployment chart | The proportion of your usage incurred by each of your deployments for one or all projects. To learn more, see [Invoice Charts.](https://www.mongodb.com/docs/atlas/billing.md#std-label-invoice-charts) | | Summary By Project table | A summarized list of usage costs per project, excluding [subscription](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-activate-subscription) charges. | | Summary by Service table | List of all Atlas services, App Services, MongoDB Charts, Atlas Embedding and Reranking API, and Atlas Subscription Plans with corresponding usage costs for each service, and the total usage amount. Atlas Embedding and Reranking API charges appear under AI Model APIs. | | Usage Details | List of all line item details for each month's bill. This is a granular breakout of all services that are invoiced, including dates used and billed, quantity (the number of server hours), the project, the cloud provider that hosts the usage, the SKU rate, and the amount. Usage that isn't associated with a cloud provider appears under Other Atlas Usage. You can download the usage details as a CSV. To learn more, see [Payment and Usage Details.](https://www.mongodb.com/docs/atlas/billing/invoices.md#std-label-payment-details) | 6. Retry the payment. Locate the Payment Details section in your invoice page. Review the values in the Actions column to locate the Retry action. Click Retry. Customers in the European Economic Area (EEA) may experience payment failures due to Strong Customer Authentication (SCA), a European regulatory requirement. To learn how to authenticate a credit card and comply with SCA (Strong Customer Authentication), see [Strong Customer Authentication (SCA).](https://www.mongodb.com/docs/atlas/billing/international-usage.md#std-label-sca-changes) ### Activate a Subscription To activate a MongoDB subscription, see [Activate a Subscription.](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-activate-subscription) ## Invoices For each of your invoices, including your current invoice, you can: - View the payment amount due, the total cost of your usage for the billing period, and your billing information. - View your total credit usage and the credit unit price, if you use credits during the billing period. - Download the invoice as a PDF or CSV usage summary, or as a CSV FOCUS cost and usage report. - Pay the invoice if you have a [subscription.](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-activate-subscription) - Explore [invoice cost visualization charts](https://www.mongodb.com/docs/atlas/billing.md#std-label-invoice-charts) that show total usage costs by service and by deployment. - Review usage summaries by project and by service. - Examine [payment and usage details](https://www.mongodb.com/docs/atlas/billing/invoices.md#std-label-payment-details) that explain usage, paid charges, and pending charges per service. To learn more, see [Manage Invoices](https://www.mongodb.com/docs/atlas/billing/invoices.md#std-label-atlas-invoices) and [Understand Your MongoDB Invoice.](https://www.mongodb.com/docs/atlas/billing/invoice-breakdown.md#std-label-atlas-invoice-breakdown) ### Missed Invoice Payments If your organization fails to pay at least one invoice for over 30 days, we suspend your MongoDB Atlas organization and automatically stop your backups without terminating them. You must pay any outstanding bills to resume service. If your organization fails to pay an invoice balance for over 60 days, we lock your MongoDB Atlas organization and can terminate backups and Atlas deployments connected to your organization. You must pay all outstanding bills to resume service. ## Cost Visualizations ### Year-to-Date Usage Chart On the Billing Overview page, a Usage chart displays your organization's Atlas usage over the last 12 months. It does not include subscription charges. ![A bar chart displaying charges per day and a donut chart comparing usage by project.](/images/billing-overview-chart-2.png) You can view usage data by service, by project, or by deployment: #### By Service The Usage chart displays stacked columns representing the total usage for each type of Atlas service across all of your projects each month. Atlas services include: - Clusters - Flex clusters - MongoDB Charts - Data Federation - Backup - Data transfer - Other Atlas features #### By Project The Usage chart displays stacked columns representing the usage by each of your projects each month. **Note:** The By Project view is unavailable for organizations using 20 or more projects. #### By Deployment The Usage chart displays stacked columns representing the usage by each of your clusters, including Flex clusters, each month. It does not include data transfer costs for Charts and Data Federation. **Note:** The By Deployment view is unavailable for: - Organizations using 20 or more deployments - Cloud Manager ### Invoice Charts Each of your invoices displays Total Usage and By Deployment charts. The charts do not include any applicable monthly or flex commitment shortfall amounts. #### Total Usage Chart ![Bar chart displaying credit usage by billed date.](/images/total-usage-invoice-chart.png) The Total Usage chart displays the costs incurred by your Atlas usage over the invoice period. You can filter usage by service to view charges incurred by a particular Atlas service. Atlas services include: - Clusters - Flex clusters - MongoDB Charts - Data Federation - Backup - Data transfer - Other Atlas features #### By Deployment Chart ![Bar chart displaying the usage of four projects.](/images/by-deployment-invoice-chart-2.png) The By Deployment chart displays the proportion of your usage incurred by each of your clusters across all your projects. You can filter the chart by project to view usage incurred by clusters in a particular project. ### Billing Cost Explorer The Billing Cost Explorer helps you understand your organization's billing data on a month-to-month basis. You can view monthly billing data in chart and table form. **Note:** To view the billing data in the Billing Cost Explorer, you must be an [`Organization Owner`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Owner), [`Organization Billing Admin`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Billing-Admin), or [`Organization Billing Viewer`.](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Billing-Viewer) To access the Billing Cost Explorer: 1. In Atlas, go to the Cost Explorer page for your organization. If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar. In the sidebar, click Cost Explorer under the Billing header. The [Cost Explorer](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2FcostExplorer) page displays. ### Usage By Month Chart The Cost Explorer tab displays the Usage By Month bar chart which visualizes your organization's Atlas usage over the past six-month-window. Your can access your billing data up to the past 18 months. The x-axis shows months and the y-axis shows usage. ![Bar chart displaying the monthly usage grouped by service for the past six months.](/images/cost-explorer-visualization-by-service.png) **Note:** If you have a sales contract with MongoDB, the usage displayed in the y-axis refers to the credit amounts, not dollars. You can filter and group usage data by organization, project, cluster, and service. You can also filter for dates to look at specific time ranges. Selecting the Include partially matching charges checkbox displays general support charges that may not be tied to specific organizations, projects, or services. Atlas attributes daily support charges to the cloud provider that hosts your usage. Your organization-wide support minimum is calculated monthly and isn't tied to a specific cloud provider. ![A filter box with options for organizations, projects, clusters, services, start and end dates, and support charges.](/images/cost-explorer-filter.png) You can collapse the filter while retaining information on the enabled filters. ![A collapsed filter box with options for organizations, projects, and start and end dates.](/images/cost-explorer-filter-collapsed.png) The chart only shows the largest 19 items for each month, bucketing the rest in an Other category. If your organization uses cross-organizational billing, you can view billing data across all linked organizations. You can explore your billing data by grouping them by the following: #### By Organization The Usage By Month chart displays stacked columns representing the total usage by each of your organizations each month. #### By Project The Usage By Month chart displays stacked columns representing the total usage by each of your projects each month. **Note:** The Project filter is unavailable for organizations using 1000 or more projects. #### By Cluster The Usage By Month chart displays stacked columns representing the usage by each of your clusters each month. **Note:** The Cluster filter is unavailable for organizations using 1000 or more clusters. #### By Service The Usage By Month chart displays stacked columns representing the total usage by each type of Atlas service you have used across all of your projects each month. Atlas services include: - Clusters - Storage - Flex clusters - Backup - Cloud Backup - Data Transfer - BI Connector - Premium Features - Data Federation - App Services - Charts - Support ### Usage By Month Table The Usage By Month table below the bar chart displays the billing data shown in the chart, adjusted by any filters and groupings you selected. You can export the table data to a .csv file by clicking on csv. ![A table displaying the billing data for the past six months.](/images/cost-explorer-usage-details.png) ### Limitations Monthly billing data is available only for the past 18 months. You cannot view Cloud Manager billing data in the Cost Explorer. ## Cross-Organization Billing *Cross-organization billing* is an Atlas subscription feature that enables you to share a billing subscription across many [organizations](https://www.mongodb.com/docs/atlas/tutorial/manage-organizations.md#std-label-manage-org-access) and to pay a single invoice for them. After [configuring a paying organization](https://www.mongodb.com/docs/atlas/billing.md#std-label-configure-paying-org), you pay invoices for the paying organization that include a list of charges incurred for all linked organizations. A paying organization's Overview tab includes Pending Invoice sections that display the following information: - The paying and linked organizations' combined charges - The paying organization's charges To display linked organizations and their contributions to the Pending Invoice, view the [payment details](https://www.mongodb.com/docs/atlas/billing/invoices.md#std-label-payment-details) section of your organization's invoice. Linked organizations are subject to the subscription agreement of the paying organization, including the level of support, the charges associated with the subscription, discounts, and payment terms. ### Linked Organization Invoices You pay for all linked organization usage through the paying organization. To help you account for usage, each linked organization has its own monthly invoice. Linked organization invoices include: - All charges incurred by that organization. - A percentage of your total cross-organization billing subscription cost proportional to that organization's usage. Each day, Atlas bills linked and paying organizations for subscription uplift based on their own usage. At the end of a paying organization's billing period, Atlas bills linked and paying organizations proportionally to their usage for the unmet monthly minimum, if there is one. **Example:** A paying organization has an Atlas Pro subscription and two linked organizations. The paying organization incurs no charges. Linked organization #1 incurs $400 in subscription uplift charges while linked organization #2 incurs $200 in subscription uplift charges. The paying organization has a monthly minimum of $799, so at the end of the month, the unmet $199 is proportionally distributed across invoices for linked organizations #1 and #2: - Atlas charges linked organization #1 $132.70 of the unmet $199 because it incurred 2/3 of the total charges. - Atlas charges linked organization #2 $66.30 of the unmet $199 because it incurred 1/3 of the total charges. You still pay all charges through the paying organization. **Note:** At the end of the paying organization's billing period, simultaneous charges for daily subscription uplift and an unmet minimum could trigger daily maximum billing alerts. ### Use Cases Use cross-organization billing to: - Create broad levels of authorization using Atlas organizations. - Exceed the 250-project limit on Atlas organizations. **Example:** A company with sales and engineering teams requires that each team has different organization-level authorization. At the same time, the company prefers to receive a single invoice for the company's database use. To pay all costs through that paying organization and maintain control over the authorizations of each team organization, the company can: 1. Create two organizations for sales and engineering. 2. Link these organizations to a paying organization. A company with over 250 projects might create new organizations for new projects, then link all organizations to a paying organization to maintain a single source of invoicing. ### Configure a Paying Organization #### Prerequisites - A paying organization must have an Atlas subscription. - To link an organization to a paying organization, you must have [`Organization Billing Admin`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Billing-Admin) or [`Organization Owner`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Owner) privileges for both organizations. - For an organization to be linked to a paying organization, it must have the same minimums, uplifts, and SLA for their subscription plan as the paying organization or have no support plan (Atlas Basic). - A paying organization and any linked organizations or any organizations intended to be linked: - Can't have failed payments. - Can't have an active self-serve support plan. - Can't have an active self-serve marketplace subscription. - Can't have overlapping monthly commitment subscriptions. #### Limitations - An organization with an existing subscription that includes support can only join a paying organization with the same level of support. - An organization without a subscription can join a paying organization with a [subscription](https://www.mongodb.com/docs/atlas/billing/subscriptions.md#std-label-subscription-types) of any type. - You can link a paying organization to a maximum of 250 other organizations, either manually through the Atlas UI or [programatically](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorganization) via the Atlas Admin API. To link more than 250 organizations, [contact support.](https://www.mongodb.com/docs/atlas/support.md#std-label-request-support) - A paying organization can't already be a linked organization. - Paying and linked organizations in a cross-org billing configuration: - Can't activate self-serve support plans. - Can't configure a self-serve marketplace subscription. - Share a single support plan (if active). **Note:** To purchase a subscription that enables cross-organization billing, contact [MongoDB Sales.](https://www.mongodb.com/company/contact?tck=docs) To configure a paying organization and link other organizations to it: 1. (Optional) In Atlas, create an organization to configure as a paying organization. If you wish to create a new organization through which to pay, [Create an Organization.](https://www.mongodb.com/docs/atlas/access/orgs-create-view-edit-delete.md#std-label-create-organization) **Note:** You can [rename an organization](https://www.mongodb.com/docs/atlas/access/orgs-create-view-edit-delete.md#std-label-rename-organization) to reach your desired cross-organization configuration. 2. In Atlas, go to the Linked Organizations page for your organization. If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar. In the sidebar, click Linked Organizations under the Billing header. The [Linked Organizations](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2FlinkOrgs) page displays. 3. Start linking. If you are configuring a new paying organization, click Start Linking. If your organization is already a paying organization, click Link More Organizations. 4. Select organizations to link to your paying organization. A dialog box displays your selected organization under Paying organization on the left and a list of organizations you may link to it under Select organizations to link on the right. Select each organization you wish to link to your paying organization. Click Review and Finish. 5. Review and finalize your links. Confirm that your organizations are linked as intended and click Finish. The Linked Organizations tab displays your linked organizations. To link additional organizations, click Link More Organizations. ### Unlink Organizations You can unlink organizations from your paying organization. When you unlink an organization, the change takes effect upon processing your next invoice. If you change your mind and want to re-link an organization before your next invoice, you can cancel the unlinking request before that invoice is processed. **Tip:** To unlink all organizations from a paying organization and link them to another cross-organization configuration, [contact support.](https://www.mongodb.com/docs/atlas/support.md#std-label-request-support) You can unlink or cancel unlinking from the Atlas Admin UI. You must have permissions to make changes to your linked organization's billing settings. To unlink a linked organization, follow these steps: 1. In Atlas, go to the Linked Organizations page for your organization. If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar. In the sidebar, click Linked Organizations under the Billing header. The [Linked Organizations](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2FlinkOrgs) page displays. 2. Click Unlink next to the organization you want to unlink. **Important:** The organization will be unlinked upon generating your next invoice. For the current invoice period, the organization will continue to incur charges on the paying organization. After that, the organization will be unlinked and receive a separate invoice. 3. Enter and save new payment method. You can enter a credit card number or a MongoDB activation code. After the upcoming invoice, Atlas bills your new organization separately. If you want to cancel the unlinking request, navigate to the Linked Organizations tab. Click Cancel Unlinking next to the organization you want to cancel the unlinking process for. If you applied an activation code, you can apply that code to your paying organization or remove it to use elsewhere. ## Billing Quota Management You can use [billing alerts](https://www.mongodb.com/docs/atlas/reference/alert-conditions.md#std-label-billing-alerts) to help manage your billing quotas. Billing alerts notify a designated person when a bill has exceeded a USD (United States Dollars) limit, or when a credit card is about to expire. To [configure billing alerts:](https://www.mongodb.com/docs/atlas/configure-alerts.md#std-label-configure-alert-settings-tabs) 1. In Atlas, go to the Organization Settings page. If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar. In the sidebar, click Organization Settings. The [Organization Settings](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fsettings%2Fgeneral) page displays. 2. In Atlas, go to the Organization Alerts page. If it's not already displayed, select your desired organization from the Organizations menu menu in the navigation bar. In the top-right corner of the Atlas UI, click the Alerts icon. Click Alerts under the Organization header. The [Organization Alerts](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Falerts%2Flist) page displays.