Payment Terms

Update payment term

Changed on

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

patch/payment-terms/{id}

Request

  • Base URL: https://api.mvmnt.io/v1
  • URL: https://api.mvmnt.io/v1/payment-terms/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Resource ID (UUID) or client key

Query parameters

by'id' | 'key'

Specify lookup type for faster retrieval. If omitted, defaults to looking up by ID first, then falls back to client key if not found. Use by=key when you know you're providing a client key for best performance.

Request body

namestring

Payment term name

descriptionstring nullable

Payment term description

daysinteger nullable

Number of days until payment is due

quickPayFeenumber float nullable

Quick pay fee percentage

apOnlyboolean nullable

Whether this payment term is for accounts payable only

doNotUseboolean nullable

Flag to prevent using this payment term

keystring nullable

Client-defined reference identifier

Example request

{
  "name": "Net 30",
  "description": "Payment due 30 days from invoice date",
  "days": 30,
  "quickPayFee": 5,
  "key": "ERP-PAYTERM-NET30"
}

Response

Payment term updated successfully

idstring uuid required

Unique payment term identifier

namestring required

Payment term name

descriptionstring nullable

Payment term description or notes

daysinteger nullable

Number of days until payment is due

quickPayFeenumber float nullable

Quick pay fee percentage (e.g., 5 for 5%)

apOnlyboolean nullable

Whether this payment term is for accounts payable only

doNotUseboolean nullable

Flag to prevent using this payment term for new transactions

keystring nullable

Client-defined reference identifier

createdAtstring date-time required

When the payment term was created

updatedAtstring date-time required

When the payment term was last updated

deletedAtstring date-time nullable

When the payment term was soft deleted (null if active)

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Net 30",
  "description": "Payment due 30 days from invoice date",
  "days": 30,
  "quickPayFee": 5,
  "key": "ERP-PAYTERM-NET30",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T14:30:00Z"
}

Changes

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      the optional response header X-RateLimit-Reset removed for the status 429

    • info

      added subschema #2 to the response body allOf list for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status