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

# Order settlement

> Returns the settled revenue, fees, shipping and settlement for one order, split per SKU. Order-level fields are `revenueAmount` (net sales), `feeAndTaxAmount`, `shippingCostAmount`, `settlementAmount` and `currency`. Each `skuTransactions` row adds `skuId`, `skuName`, `productName`, `quantity`, `statementId` (the payout it landed in) and breakdown maps.

Affiliate commission is `feeTaxBreakdown.fee.affiliateCommissionAmount`, plus `affiliatePartnerCommissionAmount`, `affiliateAdsCommissionAmount` and `cofundedCreatorBonusAmount` when present. An order that hasn't settled yet has no rows here; use Unsettled transactions for estimates. Read live from TikTok.



## OpenAPI

````yaml api-reference/tik-tok-shop-openapi.json GET /tik_tok_shop/finance/orders/{orderId}/transactions
openapi: 3.0.3
info:
  title: 'Growi API: TikTok Shop'
  version: 1.0.0
  description: >-
    Generated by scripts/gen_tik_tok_shop.rb from Growi's TikTok Shop route
    table.
servers:
  - url: https://api.growi.io/api/public/v1
security:
  - bearerAuth: []
paths:
  /tik_tok_shop/finance/orders/{orderId}/transactions:
    get:
      summary: Order settlement
      description: >-
        Returns the settled revenue, fees, shipping and settlement for one
        order, split per SKU. Order-level fields are `revenueAmount` (net
        sales), `feeAndTaxAmount`, `shippingCostAmount`, `settlementAmount` and
        `currency`. Each `skuTransactions` row adds `skuId`, `skuName`,
        `productName`, `quantity`, `statementId` (the payout it landed in) and
        breakdown maps.


        Affiliate commission is `feeTaxBreakdown.fee.affiliateCommissionAmount`,
        plus `affiliatePartnerCommissionAmount`, `affiliateAdsCommissionAmount`
        and `cofundedCreatorBonusAmount` when present. An order that hasn't
        settled yet has no rows here; use Unsettled transactions for estimates.
        Read live from TikTok.
      parameters:
        - name: orderId
          in: path
          required: true
          schema:
            type: string
            pattern: ^\d{1,32}$
          description: The TikTok order id.
        - name: organization_id
          in: query
          required: false
          schema:
            type: integer
          description: >-
            Use the TikTok Shop of this child brand (organization id) of your
            API key's organization
      responses:
        '200':
          description: >-
            { orderId, orderCreateTime, currency, revenueAmount,
            feeAndTaxAmount, shippingCostAmount, settlementAmount, totalCount,
            skuTransactions: [...] }
          content:
            application/json:
              example:
                orderId: '576000000000000001'
                orderCreateTime: 1757096530
                currency: USD
                revenueAmount: 24.99
                feeAndTaxAmount: -7.5
                shippingCostAmount: 0
                settlementAmount: 17.49
                totalCount: 1
                skuTransactions:
                  - skuId: '1729000000000000101'
                    skuName: 30ml
                    productName: Example Serum
                    statementId: '7440000000000000001'
                    quantity: 1
                    settlementAmount: 17.49
                    revenueAmount: 24.99
                    revenueBreakdown:
                      subtotalBeforeDiscountAmount: 24.99
                      sellerDiscountAmount: 0
                    shippingCostAmount: 0
                    shippingCostBreakdown:
                      actualShippingFeeAmount: 0
                    feeTaxAmount: -7.5
                    feeTaxBreakdown:
                      fee:
                        affiliateCommissionAmount: -3.75
                        referralFeeAmount: -2
                        transactionFeeAmount: -1.75
                      tax: {}
        '400':
          description: 'Invalid params: a non-numeric orderId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '403':
          description: >-
            The shop's TikTok authorization doesn't include this data (`code:
            scope_not_granted`), so the seller has to re-authorize the shop
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '404':
          description: >-
            `organization_id` isn't an active child brand of your organization,
            or the record you asked for doesn't exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '422':
          description: >-
            No TikTok Shop is connected for this organization. A parent
            organization whose shops sit on its child brands has to pass
            `organization_id`. Also returned when the shop isn't connected
            through TikTok's official API (`code: unsupported_on_web_only_shop`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '429':
          description: >-
            Rate limited: one call every 2 seconds and an hourly cap per API
            key. See `Retry-After` and the `X-RateLimit-*` headers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '502':
          description: >-
            TikTok refused or failed. `error` is a fixed message and `code`
            names the failure when there is one
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
components:
  schemas:
    TikTokShopError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: What went wrong
        code:
          type: string
          description: Machine-readable reason, when there is one
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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