---
title: "Solicitar estorno POS"
method: PATCH
path: "/v2/charges/{uuid}/pos/refund"
tags: ["Cobranças"]
---

# Solicitar estorno POS

`PATCH /v2/charges/{uuid}/pos/refund`

Realiza o estorno de uma transação de maquininha (POS)

## Path parameters

- `uuid` string, uuid, required

## Headers

- `X-Token-Api` string, required

## Request body

- object
  - `value` number, double, required — Valor a ser estornado (deve ser o valor total disponível)
  - `updated_by` string, required — Identificação do usuário que está solicitando o estorno

## Response `200`

Estorno solicitado com sucesso

- object
  - `uuid` string, uuid
  - `originalValue` number, double
  - `value` number, double
  - `status` 'PROCESSING' | 'SUCCESS' | 'FAILED'
  - `failed_reason` string

## Other responses

- `400` — Erro de validação
- `401` — Token inativo ou inexistente
- `403` — Acesso negado
- `404` — Recurso não encontrado
- `429` — Muitas requisições
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada.md) · [All operations](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/barte/api-de-sellers-v2-atualizada/versions/f0dd55b167f1/schema)