---
title: "Cancela a Solicitação de devolução. Só pode ser realizada pelo participante que criou a solicitação."
method: POST
path: "/pix/indireto/dict/devolucao/{uuid}/cancelamento"
tags: ["Devolucao"]
---

# Cancela a Solicitação de devolução. Só pode ser realizada pelo participante que criou a solicitação.

`POST /pix/indireto/dict/devolucao/{uuid}/cancelamento`

## Request

- Base URL: `https://example.com`
- URL: `https://example.com/pix/indireto/dict/devolucao/{uuid}/cancelamento`
- Auth: none required

<br>
  <b>Idempotência</b>

<br>A operação é idempotente. Caso a solicitação já tenha sido cancelada com os mesmos parâmetros, 
            será retornada resposta equivalente à primeira requisição.

## Path parameters

- `uuid` string, uuid, required

## Headers

- `api-version` string, required
- `Authorization` string, required

## Response `200`

Quando a solicitação de devolução foi cancelada com sucesso.

- Bs2Core2PixIndiretoDictAppApisDictDevolucaoCancelarSolicitacaoDevolucaoSolicitacaoDevolucaoCancelada: Representa as informações do cancelamento de uma solicitação de devolução.
  - `correlationId` string, nullable: Retorna ou define o identificador de correlação para o suporte operacional do DICT.
  - `solicitacaoDevolucao` Bs2Core2PixIndiretoDictAppApisCompartilhadosSolicitacaoDevolucao: Representa uma solicitação de devolução.
    - `idTransacao` string, nullable: Transação sendo contestada.
    - `razao` 'Fraude' | 'FalhaOperacional' | 'DevolucaoCancelada': Representa os possíveis motivos de abertura de uma solicitação de devolução no fluxo de solicitação de devolução no DICT.
    - `valor` number, double, nullable: Valor solicitado para devolução.
    - `comentario` string, nullable: Breve descrição do motivo da solicitação de devolução.
    - `id` string, nullable: Id da solicitação.
    - `status` 'Aberto' | 'Fechado' | 'Cancelado': Representa os status possíveis de uma solicitação de devolução no no fluxo de solicitação de devolução no DICT.
    - `ispbSolicitante` string, nullable: Identificador SPB do participante solicitante da devolução.
    - `ispbContestado` string, nullable: Identificador SPB do participante sendo contestado.
    - `criadoEm` string, date-time, nullable: Data-hora da criação da requisição de devolução.
    - `modificadoEm` string, date-time, nullable: Data-hora da última atualização de status.
    - `idInfracao` string, nullable: Identificador do relato de infração no caso de devolução por fraude
    - `resultadoAnalise` 'TotalmenteAceita' | 'ParcialmenteAceita' | 'Rejeitada': Representa o status da análise de uma solicitação de devolução no fluxo de solicitação de devolução no DICT.
    - `detalhesAnalise` string, nullable: Detalhes da análise da requisição de devolução indicando a motivação do resultado.
    - `razaoRejeicao` 'SemSaldo' | 'ContaEncerrada' | 'DevolucaoNaoPermitida' | 'Outro': Representa os motivos de uma solicitação de devolução ser rejeitada no fluxo de solicitação de devolução no DICT.
    - `idTransacaoDevolucao` string, nullable: Transação de devolução (completa ou parcial).

## Other responses

- `400`: Quando informações de entrada são inválidas.
- `403`: Forbidden
- `404`: Not Found
- `503`: Server Error

---

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