---
title: "Update customer balance"
method: PATCH
path: "/stores/{storeId}/customers/{customerId}/balance"
tags: ["Customer"]
---

# Update customer balance

`PATCH /stores/{storeId}/customers/{customerId}/balance`

Updates the store-specific balance for a customer.
Requires the `stores.customers.update` permission.

## Path parameters

- `storeId` string, uuid, required
- `customerId` string, uuid, required

## Request body

- UpdateBalanceForm — Form used to update a customer's balance for a given store.
  - `newBalance` number, required — The new balance to set for the customer. Must be zero or positive.
  - `comment` string, nullable — Optional comment or reason for this balance update, for audit purposes.

## Response `200`

The object was successfully updated.

- ObjectResponse — Represents a default generic response for API endpoints.
  - `success` boolean, required — Indicates whether the operation or response was successful.
  - `message` string, nullable — A descriptive message providing additional context or information about the response.
  - `code` string, nullable — The error code (if there was an error) to use when referencing the error
  - `data` unknown

## Other responses

- `400` — The provided form information is not valid, check that the provided data is valid. You can use the 'invalidFields' field to get the list of invalid fields or just use the 'message' field.
- `401` — You are not authorized, check your API key and try again.
- `403` — You are not authorized to access this endpoint, you may be missing an API key scope or be requesting a privileged endpoint.
- `404` — One of the objects referenced by the ID given in the URL or form was not found, check the ID and try again.

---

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