---
title: "Iniciar a Devolução de um Recebimento Pix"
method: POST
path: "/pix/reverse"
---

# Iniciar a Devolução de um Recebimento Pix

`POST /pix/reverse`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev/baas/v2`
- URL: `https://sandbox.openfinance.celcoin.dev/baas/v2/pix/reverse`
- Auth: OAuth 2

Retornará o evento de confirmação via webhook **pix-reversal-out**

## Request body

- object
  - `id` string: Identificador da transação do recebimento pix.
  - `endToEndId` string: Identificador ponta-a-ponta associado ao recebimento pix.
  - `clientCode` string, required: Identificador único gerado pelo cliente.
  - `amount` number, double, required: Valor da transação.
  - `reason` string, required: Razão da Devolução.
  - `reversalDescription` string: Texto opcional a ser apresentado ao pagador contendo informações sobre a devolução..

## Response `200`

200

- object
  - `status` string
  - `version` string
  - `body` object
    - `id` string
    - `amount` number
    - `clientCode` string
    - `originalPaymentId` string
    - `endToEndId` string
    - `returnIdentification` string
    - `reason` string
    - `reversalDescription` string

## Other responses

- `400`: 400
- `401`: 401
- `404`: 404
- `500`: 500
- `504`: 504

---

[API](https://skmtc.dev/celcoin/apis/baas-v2.md) - [All operations](https://skmtc.dev/celcoin/apis/baas-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/baas-v2/revisions/98ec6869c1f2?raw)