---
title: "Cria uma Solicitação de devolução."
method: POST
path: "/pix/indireto/dict/devolucao"
tags: ["Devolucao"]
---

# Cria uma Solicitação de devolução.

`POST /pix/indireto/dict/devolucao`

## Request

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

Apenas o participante debitado pode criar uma Solicitação de devolução.

## Headers

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

## Request body

- Bs2Core2PixIndiretoDictAppApisDictDevolucaoCriarSolicitacaoDevolucaoCriarSolicitacaoDevolucao: Representa o corpo de uma solicitação de devolução. Apenas o participante debitado pode criar 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: Valor solicitado para devolução.
  - `comentario` string, nullable: Breve descrição do motivo da solicitação de devolução.

## Response `201`

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

- Bs2Core2PixIndiretoDictAppApisDictDevolucaoCriarSolicitacaoDevolucaoSolicitacaoDevolucaoCriada: Representa as informações de criação de uma solicitação 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 o corpo da requisição de criação de solicitação de devolução é inválido.
- `403`: Forbidden
- `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)