---
title: "Create Platform Transaction"
method: POST
path: "/tax/platform/transactions"
---

# Create Platform Transaction

`POST /tax/platform/transactions`

Record completed sales from a platform calculation. For payment processors, this creates two transactions: one for the order and one for the fee. For marketplace providers or merchants of record, only the order transaction is created.

## Headers

- `X-API-Version` '2026-01-01', required

## Request body

- PlatformTransactionRequest — Request body for creating transactions from a platform calculation
  - `platform_calculation_id` string, required — The ID of the platform calculation to convert to transactions
  - `reference_order_id` string, required — Your unique identifier for this order
  - `reference_payment_id` string — Your unique identifier for the payment (optional)
  - `transaction_processed_at` number — Unix timestamp when the transaction was processed

## Response `200`

Platform transaction list response

- PlatformTransactionListResponse — Response containing the list of created transactions. Payment processors receive two transactions (order + fee), while marketplace providers and merchants of record receive one.
  - `object` string
  - `transactions` PlatformTransactionItem[]
    - `id` string — Unique identifier for the transaction
    - `object` string
    - `calculation_id` string — The platform calculation ID this transaction was created from
    - `reference_order_id` string — Your reference order ID
    - `reference_payment_id` string — Your reference payment ID (if provided)
    - `type` 'order' | 'fee' — Whether this is an order transaction or a fee transaction
    - `client_role` string[] — The platform role(s) for this transaction. Fee transactions have an empty array.
    - `merchant` object
      - `id` string — The merchant ID
      - `reference_merchant_id` string — Your reference merchant ID
    - `customer_currency_code` string
    - `filing_currency_code` string
    - `line_items` TransactionLineItem[]
      - `product` object
        - `reference_product_name` string
        - `reference_line_item_id` string
        - `reference_product_id` string
        - `product_tax_code` string
      - `tax_jurisdictions` object[]
        - `tax_rate` number — The tax rate percentage applied to this transaction.
        - `tax_due_decimal` number — Tax amount due for this jurisdiction in the currency's smallest unit.
        - `rate_type` string — Descriptive rate classification for this jurisdiction.
        - `fee_amount` number — The flat fee that is added to this transaction. Like all numeric values, this will be returned in cents and should be added directly to the tax amount independent of other percentages. For example, a $100 transaction taxed at 5% and with a `fee_amount: 50` will lead to `($100 * 5% + 0.50) = $5.50` in tax being charged
        - `tax_authority_name` string — Name of the tax authority.
        - `tax_authority_type` string — Type of tax authority (e.g., STATE, COUNTY, CITY, DISTRICT).
        - `tax_type` string — Type of tax: SALES, USE, VAT, or GST.
      - `quantity` number
      - `tax_amount` number
      - `amount_excluding_tax` number
      - `amount_including_tax` number
    - `testmode` boolean
    - `transaction_processed_at` number

## Other responses

- `400` — Validation error
- `404` — Platform calculation not found

---

[API](https://skmtc.net/numeral-com/apis/numeral-api.md) · [All operations](https://skmtc.net/numeral-com/apis/numeral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral-com/numeral-api/versions/f0af51c3f9b9/schema)