Update Payment Term | Papertracc Docs

curl -X PATCH https://api.papertracc.com/v1/configs/payment-terms/c81e7a35-2f4d-4b6c-9a0e-5d3b7f1c8e92 \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "50/50 split",
  "instalments": [
    {
      "type": "PERCENTAGE_RATE",
      "value": 50,
      "net_days": 15
    },
    {
      "type": "PERCENTAGE_RATE",
      "value": 50,
      "net_days": 30
    }
  ]
}'

{
  "data": {
    "id": "c81e7a35-2f4d-4b6c-9a0e-5d3b7f1c8e92",
    "project_id": "spruce-demo",
    "name": "50/50 split",
    "net_days": 30,
    "is_default": false,
    "is_active": true,
    "instalments": [
      {
        "type": "PERCENTAGE_RATE",
        "value": "50",
        "net_days": 15
      },
      {
        "type": "PERCENTAGE_RATE",
        "value": "50",
        "net_days": 30
      }
    ],
    "discount": null,
    "created_at": "2026-06-18T10:00:00Z"
  },
  "status": true,
  "message": "Successfully updated payment term"
}

Updates a payment term. Fields left out are unchanged. instalments replaces the existing instalments, and an empty array turns the term back into a single due date. Send clear_discount to remove the early-payment discount. Set is_active to false to retire a term.

Documents keep the schedule they were given when the term was applied, so editing or deactivating a term does not change existing invoices or bills.

Requires the can_modify_payment_term permission on the key owner’s role. Available when the Invoices or Bills service is enabled for the workspace.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

identitystring

The identity for the active project.

Path parameters

idstringRequired

Payment term ID.

Request

This endpoint expects an object.

namestringOptional<=50 characters

net_daysintegerOptional0-365

is_defaultbooleanOptional

is_activebooleanOptional

Deactivating a term also removes it as the workspace default.

instalmentslist of objectsOptional

Replaces the instalments. Send an empty array to turn the term back into a single due date, or omit the field to keep the existing ones.

discountobjectOptional

Replaces the early-payment discount.

clear_discountbooleanOptional

Send true to remove the early-payment discount.

Response

dataobject

statusboolean

messagestring

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error