---
title: "PATCH /clinic-config/financial - Update financial settings"
method: PATCH
path: "/clinic-config/financial"
tags: ["ClinicConfig"]
---

# PATCH /clinic-config/financial - Update financial settings

`PATCH /clinic-config/financial`

## Request body

- FinancialSettingsDto — Financial and pricing settings
  - `stateTaxRate` union
    - number, double
    - string, double
  - `countyTaxRate` union
    - number, double
    - string, double
  - `cityTaxRate` union
    - number, double
    - string, double
  - `quickAddServiceIds` string[], nullable
  - `xplorPayEnabled` boolean
  - `xplorPayTestMode` boolean
  - `xplorPayCredentialsConfigured` boolean — Whether XplorPay credentials are stored in AWS Secrets Manager. Use /integrations/credentials/xplorpay endpoints to manage.
  - `xplorPayTerminalApiKey` string, nullable
  - `xplorPayPayLinkApiKey` string, nullable
  - `markAsPaidTypes` string[], nullable
  - `passProcessingFeesToClient` boolean
  - `depositAccount` string, nullable
  - `accountingMode` string, nullable
  - `taxMode` string, nullable
  - `vatStandardRate` union
    - number, double
    - string, double
  - `vatReducedRate` union
    - number, double
    - string, double
  - `discountStackingMode` string — How the price rule engine resolves multiple discounts hitting the same line (or the order): "best-wins" keeps only the largest, "stack" sums them. An individual rule may override this via `PriceRule.StackingOverride`.
  - `paymentMethodNotices` PaymentMethodNoticeDto[], nullable — Admin-authored notices shown when a given payment method is used at checkout. Keyed by surface (e.g. `payment.check`) so the model can extend beyond payment methods later without a migration.
    - `surfaceKey` string — Keyed surface, e.g. `payment.check`.
    - `text` string — The notice text shown to staff.
    - `severity` string — Severity ("Low" | "Normal" | "High" | "Critical").

## Response `200`

OK

- FinancialSettingsDto — Financial and pricing settings
  - `stateTaxRate` union
    - number, double
    - string, double
  - `countyTaxRate` union
    - number, double
    - string, double
  - `cityTaxRate` union
    - number, double
    - string, double
  - `quickAddServiceIds` string[], nullable
  - `xplorPayEnabled` boolean
  - `xplorPayTestMode` boolean
  - `xplorPayCredentialsConfigured` boolean — Whether XplorPay credentials are stored in AWS Secrets Manager. Use /integrations/credentials/xplorpay endpoints to manage.
  - `xplorPayTerminalApiKey` string, nullable
  - `xplorPayPayLinkApiKey` string, nullable
  - `markAsPaidTypes` string[], nullable
  - `passProcessingFeesToClient` boolean
  - `depositAccount` string, nullable
  - `accountingMode` string, nullable
  - `taxMode` string, nullable
  - `vatStandardRate` union
    - number, double
    - string, double
  - `vatReducedRate` union
    - number, double
    - string, double
  - `discountStackingMode` string — How the price rule engine resolves multiple discounts hitting the same line (or the order): "best-wins" keeps only the largest, "stack" sums them. An individual rule may override this via `PriceRule.StackingOverride`.
  - `paymentMethodNotices` PaymentMethodNoticeDto[], nullable — Admin-authored notices shown when a given payment method is used at checkout. Keyed by surface (e.g. `payment.check`) so the model can extend beyond payment methods later without a migration.
    - `surfaceKey` string — Keyed surface, e.g. `payment.check`.
    - `text` string — The notice text shown to staff.
    - `severity` string — Severity ("Low" | "Normal" | "High" | "Critical").

---

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