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

# Solicitar estorno POS

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

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/v2/charges/{uuid}/pos/refund`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/v2/charges/:uuid/pos/refund/patch.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)