---
title: "🧪 Update a sale transaction"
method: PATCH
path: "/sellers/{seller_id}/sale-transactions/{id}"
tags: ["Sales", "snbx"]
---

# 🧪 Update a sale transaction

`PATCH /sellers/{seller_id}/sale-transactions/{id}`

## Path parameters

- `seller_id` string, required — An object id with prefix
- `id` string, required — An object id with prefix

## Headers

- `if-match` string, date-time, required — [ETag](https://en.wikipedia.org/wiki/HTTP_ETag) value for [Optimistic Concurrency Control (OCC)](https://en.wikipedia.org/wiki/Optimistic_concurrency_control). Should contain the last known updated_at timestamp in ISO 8601 format.

## Request body

- object
  - `amount` integer — Gross sale amount charged to buyer
  - `created` string, date-time — Date of sale transaction
  - `currency` string — Currency of sale transaction (ISO-4217)
  - `fee` integer — Fee amount charged by payment processor
  - `net` integer — Net amount received by seller after processor fees
  - `reporting_category` string — Reporting category used for financial purposes
  - `available_on` string, date-time, nullable — Date of payout from payment processor
  - `buyer_id` string, nullable — Identifier for the buyer
  - `subscription_id` string, nullable — Identifier for the subscription
  - `source` string, nullable — External identifier indicating the source of the sale transaction
  - `description` string, nullable — Description of the sale transaction
  - `exchange_rate` number, nullable — Exchange rate used for the sale transaction
  - `fee_details` object[], nullable — Fee details associated with the sale transaction
    - `amount` integer, required — Non-negative integer amount in lowest currency denomination. See [Money](/docs/money) for details.
    - `application` string — Non-empty text string
    - `currency` string, required — ISO 4217 currency code
    - `description` string — Non-empty text string
    - `type` 'application_fee' | 'payment_method_passthrough_fee' | 'stripe_fee' | 'tax', required
  - `metadata` object, nullable — Additional metadata associated with the sale transaction

## Response `200`

Successful operation

- object
  - `amount` integer, required — Gross sale amount charged to buyer
  - `created` string, date-time, required — Date of sale transaction
  - `currency` string, required — Currency of sale transaction (ISO-4217)
  - `fee` integer, required — Fee amount charged by payment processor
  - `net` integer, required — Net amount received by seller after processor fees
  - `reporting_category` string, required — Reporting category used for financial purposes
  - `available_on` string, date-time — Date of payout from payment processor
  - `buyer_id` string — Identifier for the buyer
  - `subscription_id` string — Identifier for the subscription
  - `source` string — External identifier indicating the source of the sale transaction
  - `description` string — Description of the sale transaction
  - `exchange_rate` number — Exchange rate used for the sale transaction
  - `fee_details` object[] — Fee details associated with the sale transaction
    - `amount` integer, required — Non-negative integer amount in lowest currency denomination. See [Money](/docs/money) for details.
    - `application` string — Non-empty text string
    - `currency` string, required — ISO 4217 currency code
    - `description` string — Non-empty text string
    - `type` 'application_fee' | 'payment_method_passthrough_fee' | 'stripe_fee' | 'tax', required
  - `metadata` object — Additional metadata associated with the sale transaction
  - `skip_reasons` object — If skipped, provides reasons for skipping the sale transaction
    - `unsupported_currency` string — Non-empty text string
    - `payin_configuration` string — Non-empty text string
    - `term_expired` string — Non-empty text string
    - `exceeds_max_sale_amount` string — Non-empty text string
    - `exceeds_max_payin_balance` string — Non-empty text string
    - `exceeds_max_term` string — Non-empty text string
    - `simulation_failed` string — Non-empty text string
    - `conflict` string — Non-empty text string
  - `payout_id` string — ID of the ledger entry for the associated payout
  - `id` string, required — An object id with prefix
  - `created_at` string, date-time, required — Creation date and time
  - `created_by` string, required — ID of the user that created this object
  - `updated_at` string, date-time, required — Last update date and time
  - `updated_by` string, required — ID of the user that last updated this object

---

[API](https://skmtc.net/sivo/apis/sivo-advance-api.md) · [All operations](https://skmtc.net/sivo/apis/sivo-advance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sivo/sivo-advance-api/revisions/bfbcd2bfed61/schema)