> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing

> How media billing responsibility and platform-fee collection work, what remittance details to use, and how to keep billing info current

Who invoices media is set per transaction by its **billing party**:

* **Apostra-cleared (`agent`)** — Apostra finance issues the media invoice
  and it carries the bank remittance details to pay against.
* **Operator-billed** — the seller or connected platform bills the account
  operator directly.
* **Advertiser-billed** — the seller or connected platform bills the advertiser
  directly.

For compatibility, `agent` projects to legacy `Decisioned`, while `operator`
and `advertiser` both project to legacy `Routed`. That projection is lossy:
`Routed` cannot distinguish the operator from the advertiser. Billing party
remains the authority for who invoices; `routingType` does not say whether
optimization happened or which adapter/execution path was used.

For a seller-sponsored buyer, the sponsoring seller fixes this authority at
provisioning time: `prepay` selects Apostra-cleared `agent`, while `credit`
selects seller direct-billed `operator`. The sponsored account remains the
seller's governed account, and the buyer cannot change that billing choice.

<Note title="IU charges are a separate stream">
  Platform/IU fees are a separate billing stream from media. For organizations
  whose IU Rate Card and charging feature are enabled, Apostra issues a separate
  fee invoice and may collect it through the invitation-only card rail. Existing
  accepted media-pricing arrangements remain separate and unchanged.
</Note>

<Note title="Media funding is not the card rail">
  Sponsored `prepay` uses the existing media invoice/deposit funding and
  account-capacity mechanisms. It does not make platform-fee card collection an
  automated media-funding flow. Sponsored `credit` is seller direct billing,
  not an Apostra-granted credit line.
</Note>

Keep your **billing info** current for Apostra-issued media or platform-fee
invoices — who the invoice is addressed to and where it is sent. Manage it in
**Account settings → Plan & Billing → Payment & invoices** or via
the API (updates are admin-only):

```
GET /api/v2/billing/info
PUT /api/v2/billing/info
```

Authenticate every request with `Authorization: Bearer $SCOPE3_API_KEY`.

## What Apostra needs for its invoices

The minimum for an invoice you can pay — and that your accounts-payable team
will accept — is a **payer name** and a **payer address**. Beyond that, keep
these current so invoices route correctly:

| Field                     | Purpose                                     |
| ------------------------- | ------------------------------------------- |
| Billing contact name      | Who the invoice is addressed to             |
| Billing email + CC emails | Where the invoice is delivered              |
| Phone                     | Finance-team contact for payment queries    |
| Billing address           | The payer address printed on the invoice    |
| Tax ID                    | VAT/EIN or equivalent for your jurisdiction |

## Where the remittance details come from

Bank remittance details are printed **on each Apostra-issued invoice** — you do
not need to request them separately, and you should always pay against the
details on the invoice you received. Apostra maintains a bank account per
invoicing currency, so the remittance details match the currency you are billed
in. A card-collected platform/IU fee instead follows the saved-card flow shown
in Plan & Billing.

## When invoices arrive

Apostra-issued invoices follow your billing cycle and payment terms. A media
invoice covers only Apostra-cleared activity; operator- and
advertiser-billed media follows that counterparty's invoice process. Questions
about an Apostra invoice go to the finance contact listed on it.

## Billing activity

The **Invoice activity** section at the top of the Invoices tab on the org
Billing page shows invoice activity as it happens — status, what it's for,
currency, amount, and due/paid date — via
[Get invoice activity](/v2/buyer/billing/tasks/get-invoice-activity). It's
empty until your organization has an issued IU fee invoice; media invoice
activity and other reserved row kinds do not have producers yet.

## Task reference

<CardGroup cols={2}>
  <Card title="Get billing info" href="/v2/buyer/billing/tasks/get-billing-info" icon="address-card">
    `GET /billing/info` — current contact, address, tax ID
  </Card>

  <Card title="Update billing info" href="/v2/buyer/billing/tasks/update-billing-info" icon="pen-to-square">
    `PUT /billing/info` — keep invoicing details current
  </Card>

  <Card title="Get invoice activity" href="/v2/buyer/billing/tasks/get-invoice-activity" icon="receipt">
    `GET /billing/invoice-activity` — invoice activity as it happens
  </Card>
</CardGroup>