---
title: "Edit Customer Balance"
method: PUT
path: "/v1/shops/{shopId}/customers/{customerId}/balance"
tags: ["Customers"]
---

# Edit Customer Balance

`PUT /v1/shops/{shopId}/customers/{customerId}/balance`

## Request

- Base URL: `https://api.sellauth.com`
- URL: `https://api.sellauth.com/v1/shops/{shopId}/customers/{customerId}/balance`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sellauth/apis/sellauth-api/docs/v1/shops/:shopId/customers/:customerId/balance/put.ts> (a function with typed inputs; its response is checked against the schema)

Adds or deducts balance to/from a customer in a shop.

## Request body

- object
  - `amount` number, required
  - `description` string, nullable: Must not be greater than 255 characters.
  - `invoice_id` integer, nullable

## Response `200`

## Changes

- **2026-11-02** `ff0d59c98d7a`: 2 info
  - the request property `description` became nullable
  - the request property `invoice_id` became nullable

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/customers/:customerId/balance/put.md)

---

[API](https://skmtc.dev/sellauth/apis/sellauth-api.md) - [All operations](https://skmtc.dev/sellauth/apis/sellauth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sellauth/apis/sellauth-api/revisions/ff0d59c98d7a?raw)