> ## 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**:

* **Consolidated billing (`agent`)** — the seller sends its invoice to Apostra
  instead of to you. Apostra finance puts it on your consolidated media invoice,
  which carries the bank remittance details to pay against, and passes your
  payment to the seller once it arrives. Apostra acts as a billing agent: it
  does not guarantee the seller's payment, does not pay the seller before you
  pay, and takes no credit risk on the seller's media. The seller carries that
  credit risk.
* **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 consolidated billing (`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 from the card saved on Plan & Billing. 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 consolidated-billing 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.