Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(Billing): Update the Billing section articles, added the Crowdi… #123

Merged
merged 6 commits into from
Sep 20, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified src/assets/screenshots/crowdin/billing/app_subscription.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified src/assets/screenshots/crowdin/billing/download_invoice.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified src/assets/screenshots/crowdin/billing/plan_upgrade.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file modified src/assets/screenshots/enterprise/billing/app_subscription.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified src/assets/screenshots/enterprise/billing/download_invoice.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified src/assets/screenshots/enterprise/billing/plan_upgrade.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
6 changes: 3 additions & 3 deletions src/content/docs/crowdin/billing/app-subscriptions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: App Subscriptions
description: Learn how to subscribe to paid apps in Crowdin Store
slug: app-subscriptions
sidebar:
order: 3
order: 4
---

import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
Expand All @@ -29,7 +29,7 @@ Depending on the date you activate the paid app subscription in relation to your

## Subscribing to Paid App

Once the 14-day trial period ends, you'll be asked to subscribe to continue using the paid app. To subscribe to the paid app, follow these steps:
Once the 14-day trial period ends, you'll be asked to subscribe to continue using the paid app. To subscribe to the paid app, follow these steps:

<Steps>
1. Open the app you'd like to purchase a subscription for. Depending on the app type, it might be located in the Crowdin UI in the project's Integrations tab, Editor, etc.
Expand All @@ -56,7 +56,7 @@ You can view your currently active paid app subscriptions, and if needed, you ca
To suspend paid app subscription, follow these steps:

<Steps>
1. Go to **Account Settings > Payments**.
1. Go to **Account Settings > Billing**.
2. Click **Suspend** toward the app name.
</Steps>

Expand Down
123 changes: 123 additions & 0 deletions src/content/docs/crowdin/billing/crowdin-managed-services.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,123 @@
---
title: Crowdin Managed Services
description: Learn how to use Crowdin Managed Services
slug: crowdin-managed-services
sidebar:
order: 3
---

import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
import { Image } from 'astro:assets';
import usageStats from '!/crowdin/billing/usage_statistics.png';
import balanceManagement from '!/crowdin/billing/balance_management.png';

Crowdin offers a range of additional services that can significantly improve your localization workflow while simplifying payment and service management. These services are managed directly through your Crowdin account using a dedicated balance separate from your primary subscription. This means you don't need to register additional accounts to access MT engines, AI models, or translation vendors, such as Crowdin Language Services. By consolidating payments in one place, you gain greater control over your localization resources and expenses, ensuring seamless workflow integration.

## Available Services

Crowdin can manage the following paid services:

- **MT engines** (e.g., DeepL Pro)
- **AI models** (e.g., OpenAI, Google Gemini, and other providers)
- **Translation vendors** (Crowdin Language Services)

<CardGrid>
<LinkCard
title="Machine Translation"
description="Read more about Machine Translation and how to use it."
href="/machine-translation/"
/>
<LinkCard
title="Crowdin AI"
description="Read more about Crowdin AI and how to use it."
href="/crowdin-ai/"
/>
<LinkCard
title="Crowdin Language Services"
description="Order professional translations and proofreading services."
href="/crowdin-language-services/"
/>
</CardGrid>

## Using Crowdin Managed Services

Crowdin Managed Services simplifies the use of paid tools like MT engines, AI models, and translation vendors by handling payments through a dedicated balance within your Crowdin account. This centralizes balance management and provides a clear overview of your spending.

In the **Crowdin Managed Services** section, you can:

- **Manage Balance**: Add funds to your dedicated balance for the Crowdin Managed Services you use.
- **Set Balance Warnings**: Receive notifications when your balance is low.
- **Track Usage**: View spending with detailed usage statistics.

To start using Crowdin Managed Services, [top up your account balance](#topping-up-account-balance) and activate the **managed by Crowdin** option for the services you want to use in your projects.

## Managing Your Dedicated Balance

You can manage your Crowdin Managed Services balance by adding funds and setting up notifications about low balance.

<Image src={balanceManagement} alt="Balance Management" />

### Topping Up Account Balance

To add funds to your balance, follow these steps:

<Steps>
1. Open your **Account Settings** and go to the **Billing** tab.
2. Locate the **Crowdin Managed Services** section.
3. Enter the desired amount in the **Top Up Balance** field.
4. Click **Top Up** to proceed to the checkout page, where you can complete the payment.
</Steps>

### Setting Balance Warning Threshold

To ensure the uninterrupted operation of the Crowdin Managed Services, you can set the preferred amount in the **Balance warning threshold** field so that when your balance reaches this point, you'll automatically receive a notification.

To set up low-balance notifications, follow these steps:

<Steps>
1. Open your **Account Settings** and go to the **Billing** tab.
2. Locate the **Crowdin Managed Services** section.
3. Enter your desired threshold amount in the **Balance warning threshold, $** field.
4. Click **Save** to confirm your settings.
</Steps>

## Usage Statistics

The **Usage Statistics** section provides a comprehensive visual analysis of your usage costs through an interactive graph, allowing you to review detailed statistics and track spending on each service based on your selected time period. In addition to the graph, the **Withdrawn during the selected time period** field shows the total amount spent during the chosen period.

The graph displays usage costs for each service from the [available categories](#available-services). Hover over any bar to see a breakdown of the expenses per service for that day, month, or year.

Depending on the selected date range, each stacked bar represents:

* **One day** for ranges up to **2 months**.
* **One month** for ranges up to **24 months**.
* **One year** for ranges over **24 months**.

You can also focus on specific services by hovering over the service titles under the graph. To hide certain services from the graph, click on their names.

<Image src={usageStats} alt="Usage Statistics" />

## See Also

<CardGrid>
<LinkCard
title="Payments and Invoices"
description="Learn how payments work in Crowdin and how to download invoices."
href="/payments-invoices/"
/>
<LinkCard
title="Changing Subscription Plan"
description="Upgrade or downgrade your subscription plan."
href="/changing-subscription-plan/"
/>
<LinkCard
title="App Subscriptions"
description="Learn how to subscribe to paid apps in the Crowdin Store."
href="/app-subscriptions/"
/>
<LinkCard
title="Billing Settings"
description="Update your billing information and payment method."
href="/billing-settings/"
/>
</CardGrid>
6 changes: 3 additions & 3 deletions src/content/docs/crowdin/billing/payments-invoices.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ How you will be charged for Crowdin services depends on the subscription type yo

### Monthly Plans

The monthly plans use a recurring payment model. Once you subscribe to the monthly plan, your account limits will be set accordingly to the selected plan, and you'll be instantly charged for a billing cycle (i.e., one month). The following charge will be automatically conducted at the beginning of the next billing cycle.
The monthly plans use a recurring payment model. Once you subscribe to the monthly plan, your account limits will be set accordingly to the selected plan, and you'll be instantly charged for a billing cycle (i.e., one month). The following charge will be automatically conducted at the beginning of the next billing cycle.

If you upgrade or downgrade in the middle of the monthly billing cycle, your account limits will be instantly updated, and starting the next billing cycle, you will be charged for the new plan.

Expand All @@ -35,7 +35,7 @@ As the annual subscription doesn't renew automatically, we will send you a remin
To download invoices in Crowdin, follow these steps:

<Steps>
1. Go to **Account Settings > Payments**.
1. Go to **Account Settings > Billing**.
2. Choose the needed invoice from the list and click **Download**.
</Steps>

Expand All @@ -50,7 +50,7 @@ Also, you can download invoices via FastSpring, our payment processing partner.
<Steps>
1. Go to the [FastSpring Account Management page](https://crowdin.onfastspring.com/account).
2. To log in, specify the same email that was used to purchase your Crowdin subscription.
3. Click **Continue**.
3. Click **Continue**.
</Steps>

If you have active Crowdin app subscriptions, they will be represented in the downloaded invoice along with the primary Crowdin subscription.
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/crowdin/billing/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Billing Settings
description: Update your billing information and payment method
slug: billing-settings
sidebar:
order: 4
order: 5
---

import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
Expand Down Expand Up @@ -31,7 +31,7 @@ As a result, the updated billing information will be applied to future payments.

## Updating Payment Method

You can change the payment method used for your Crowdin subscription.
You can change the payment method used for your Crowdin subscription.

To update your payment method, follow these steps:

Expand Down
35 changes: 35 additions & 0 deletions src/content/docs/crowdin/integrations/content-delivery.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@ import webFlow from '!/crowdin/integrations/content_delivery_web.png';
import mobileFlow from '!/crowdin/integrations/content_delivery_mobile_server_desktop.png';
import addDistribution from '!/crowdin/integrations/content_delivery_add_distribution.png';
import releaseDistribution from '!/crowdin/integrations/content_delivery_release_distribution.png';
import usagePrice from '!/crowdin/integrations/content_delivery_usage_price.png';
import usageStats from '!/crowdin/integrations/content_delivery_usage_statistics.png';

Over-the-Air Content Delivery is a feature that allows you to instantly update sources and translations in your mobile, server, desktop, or web apps with a single click without preparing a new release.

Expand Down Expand Up @@ -127,3 +129,36 @@ For example, if a distribution contains 20 files, each of which is 5MB, the down
To reduce requests to the CDN, you can put all the necessary content into one file (using Bundles), and when it is downloaded, the system counts one request instead of 20 separate ones. Additionally, caching configuration can be made on the app's side.

In our statistics, we use data provided by AWS. If 1,000,001 (1 million and 1) requests are made in a month, the price for requests will be $6. If 10GB and 1 byte are transferred in a month, the price for data transfer will be $4. The combined total will be $10 per month for requests and data transfer.

## Managing Your OTA Usage

You can manage your Over-The-Air Content Delivery usage price and set up notifications for daily usage limits in the **Account Settings > Billing > Over-The-Air Content Delivery**.

### OTA Usage Price

In the **Over-The-Air Content Delivery usage** section, you can see the total amount spent during the current billing cycle (one month). This includes a detailed breakdown of requests and data transfer with their respective prices. OTA usage fees are included in your primary Crowdin subscription and charged during the next billing cycle.

<Image src={usagePrice} alt="Usage Price" />

### Setting Daily Balance Warning Threshold

You can set a daily OTA usage limit, and when this threshold is exceeded, you'll receive a notification. By default, the limit is set to $30 per day. This feature helps you stay informed of your OTA usage and avoid unexpected overages. You can update the limit anytime. Additionally, if your free quota (1M requests and 10GB of data transfer) is exceeded, a one-time notification will be sent.

To set up usage notifications, follow these steps:

<Steps>
1. Open your **Account Settings** and go to the **Billing** tab.
2. Locate the **Over-The-Air Content Delivery** section.
3. Enter your desired threshold amount in the **Daily balance warning threshold, $** field.
4. Click **Save** to confirm your settings.
</Steps>

### Usage Statistics

The **Usage Statistics** section provides a visual analysis of your OTA usage via an interactive graph, showing detailed statistics for the month. You can view data for all distributions or focus on specific ones.

The graph displays three lines simultaneously: request quantity, transfer costs, and data transferred. Hover over the data points to see daily totals for each category.

You can also focus on specific category by hovering over the its title under the graph. To hide certain category from the graph, click on its title.

<Image src={usageStats} alt="Usage Statistics" />
Original file line number Diff line number Diff line change
Expand Up @@ -31,11 +31,12 @@ To configure the machine translation engines, follow these steps:
<Steps>
1. Open your profile home page and select **Machine Translation** on the left sidebar.
2. Click <Icon name="mdi:dots-horizontal" class="inline-icon" /> toward the MT engine you want to configure and select **Edit**. Alternatively, just double-click on the needed MT engine.
3. Enter the credentials for the selected translation engine.
4. *(Optional)* In the **Advanced settings** section, you can configure the following options:
3. Select **Enabled**.
4. Enter the credentials for the selected translation engine.
5. *(Optional)* In the **Advanced settings** section, you can configure the following options:
* Select the languages for which the MT engine should provide translations. Alternatively, leave empty to enable all languages.
* Select the projects in which you want to use the MT engine. Alternatively, leave empty to enable it for all projects.
5. Click **Update**.
6. Click **Update**.
</Steps>

<Aside type="caution">
Expand All @@ -62,6 +63,8 @@ DeepL API is accessible only with the DeepL API Free and Pro subscription plans

If you’re subscribed to a different subscription plan, you can switch to the DeepL API plan in your [personal account settings](https://www.deepl.com/pro-account.html). DeepL also provides a [simulator](https://www.deepl.com/docs-api/simulator) that allows you to check your Authentication Key in action.

To start using DeepL Pro managed by Crowdin, select the **DeepL managed by Crowdin** option during the MT engine configuration. In this case, you'll need to [top up your account balance](/crowdin-managed-services/#topping-up-account-balance).

### Watson (IBM) Translator

Watson (IBM) Translator offers 1,000,000 characters per month free of charge and paid plans to select from after exceeding the limit. Go to the [Watson (IBM) Services Console](https://cloud.ibm.com/catalog/services/language-translator) to get your Watson Translator API key.
Expand Down
Loading