# How to split billing across buyers

Split billing is a feature that allows you to divide the cost of a subscription across different buyers in your account. If your organization has multiple legal entities, split billing can be used to distribute costs effectively. To learn more, see [Split Billing](https://docs.platform.softwareone.com/modules-and-features/billing#split-billing).

In the SoftwareOne Marketplace, the split billing process begins by activating the feature from the user interface (UI), selecting buyers for allocation, and then specifying each buyer's allocation percentage or license count. This tutorial describes how to complete all of these steps.

In this tutorial, an agreement named *Adobe VIP Marketplace for Stark Industries* contains three subscriptions. Currently, 100% of the billing for these subscriptions is assigned to a single buyer named *Stark Industries*. We'll activate split billing, add two new buyers named *Stark Industries II* and *Stark Industries* *III*, and then specify the allocation percentage for these buyers.

### Prerequisites

Before getting started with the tutorial, it's essential to have an understanding of the platform's [key concepts](https://docs.platform.softwareone.com/marketplace-platform/platform-overview/key-concepts). You must also be familiar with the platform's interface and know how to navigate it.

### Splitting the billing across buyers

{% stepper %}
{% step %}
**Activating split billing**

Split billing can only be activated at the agreement level. To activate split billing:

1. On the **Agreements** page, select the required agreement. The agreement details page opens.
2. Select the arrow <img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/LR0kfJUNF8P38iOU0MHV/image.png" alt="" data-size="line">, then choose **Split billing**.
3. In the **Split billing** dialog, select the checkbox to enable split billing, then select **Save**.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/I3coHeH6jEYt8lvkoF79/EnableSP.png" alt=""><figcaption><p>The option to enable split billing.</p></figcaption></figure></div>

Split billing is activated, and the **Split billing** tab appears on the agreement’s details page. You are now ready to configure the buyers to whom you want to allocate billing.&#x20;
{% endstep %}

{% step %}
**Configuring buyers**

In this tutorial, *Stark Industries* is the **Owner** buyer who has been allocated 100% of the billing. We will configure *Stark Industries II* and *Stark Industries III* as additional buyers and then divide the costs across buyers.&#x20;

To configure buyers:

1. Select the **Split billing** tab on the agreement details page.
2. Select **Edit**.&#x20;

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/NmM1fQn4vWHTBMaFrt05/SplitBillingEdit.png" alt=""><figcaption><p>The Edit option on the Split billing tab.</p></figcaption></figure></div>

3. In the **Split billing** dialog, use the checkboxes to select buyers from the list of your active buyers. When done, select **Save**.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/FkazbhKteZf4ozTvhal6/SPBuyers.png" alt=""><figcaption><p>The list of buyers for billing allocation.</p></figcaption></figure></div>

*Stark Industries II* and *Stark Industries III* are added as buyers and displayed on the **Split billing** tab. You are now ready to allocate billing to these buyers.&#x20;

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/BMwHWamTgJ4ZDhdlGWnW/SPBuyers1.png" alt=""><figcaption><p>The newly assigned buyers on the Split billing tab.</p></figcaption></figure></div>
{% endstep %}

{% step %}
**Allocating split billing**

Billing can be allocated by specifying percentages for each buyer. You can also specify the estimated license count. Both of these options are linked, meaning changing one updates the other automatically, although only the allocation % is used during billing (see [Split billing rules](https://docs.platform.softwareone.com/modules-and-features/billing#split-billing-rules) to learn more).

To start configuring the split for each buyer:

1. In the **Actions** column for the **Owner** buyer, select **Details**.
2. Find the required subscription and select **Edit**. The example agreement contains three subscriptions, but we will only configure allocation for the first subscription, called *Creative Cloud All Apps with Adobe Stock*.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/qnKUce9sFJZBzN3apCE1/SplitBillingSubscription.png" alt=""><figcaption><p>The Edit option for the subscription.</p></figcaption></figure></div>

3. Under **Allocation%**, enter the allocation percentage for each buyer. Then, select **Save**. In this example, 50% of the billing is allocated to *Stark Industries* (owner buyer) and the remaining 50% to *Stark Industries II*. No split billing percentage is assigned to *Stark Industries III.*&#x20;

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/hb0w8VXnpos1xJOE0SI9/EditAllocation.png" alt=""><figcaption><p>The option to allocate percentages for buyers.</p></figcaption></figure></div>

4. The allocation is updated and displayed on the **Split billing details** page. By default, the allocation for the owner buyer is displayed:

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/g6F9wbXkXkm3IZjhh1mo/Allocation.png" alt=""><figcaption><p>The split billing details page.</p></figcaption></figure></div>

Use the Buyer menu at the top to view the allocation for the other buyers (*Stark Industries II* in this example):&#x20;

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/w0i29leAIEmPg5QBePLG/SPBuyers2.png" alt=""><figcaption><p>The option to switch betwen buyers.</p></figcaption></figure></div>

5. Select **Close**. You are returned to the **Split billing details** tab.
   {% endstep %}
   {% endstepper %}

### Next steps

If you have additional subscriptions and want to split the billing for those subscriptions, you can repeat the same steps. You can also edit the split at any time. For details, see [Edit Split Billing](https://docs.platform.softwareone.com/modules-and-features/billing/split-billing/edit-split-billing).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.platform.softwareone.com/marketplace-platform/getting-started/marketplace-for-clients/how-to-split-billing-across-buyers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
