---
title: "Update payment term"
method: PATCH
path: "/payment-terms/{id}"
tags: ["Payment Terms"]
---

# Update payment term

`PATCH /payment-terms/{id}`

Partially update a payment term. Only provided fields will be updated.

## Path parameters

- `id` string, required

## Query parameters

- `by` 'id' | 'key'

## Request body

- PaymentTermPatch — Partial payment term update. All fields are optional. - **Omitted fields**: Not modified (current value preserved) - **Provided fields**: Updated to the new value - **Null values**: Clear the field (set to null) where applicable
  - `name` string — Payment term name
  - `description` string, nullable — Payment term description
  - `days` integer, nullable — Number of days until payment is due
  - `quickPayFee` number, float, nullable — Quick pay fee percentage
  - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
  - `doNotUse` boolean, nullable — Flag to prevent using this payment term
  - `key` string, nullable — Client-defined reference identifier

## Response `200`

Payment term updated successfully

- PaymentTerm
  - `id` string, uuid, required — Unique payment term identifier
  - `name` string, required — Payment term name
  - `description` string, nullable — Payment term description or notes
  - `days` integer, nullable — Number of days until payment is due
  - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
  - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
  - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
  - `key` string, nullable — Client-defined reference identifier
  - `createdAt` string, date-time, required — When the payment term was created
  - `updatedAt` string, date-time, required — When the payment term was last updated
  - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)

## Other responses

- `400` — Bad request - invalid input
- `401` — Unauthorized - invalid or missing access token
- `404` — Resource not found
- `422` — Validation error - invalid field values
- `429` — Rate limit exceeded

---

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