---
title: "Criar devolução de um recebimento"
method: POST
path: "/payin_refunds"
---

# Criar devolução de um recebimento

`POST /payin_refunds`

## Request

- Base URL: `https://api.transfeera.com`
- URL: `https://api.transfeera.com/payin_refunds`
- Auth: HTTP bearer

## Parameters

- `#/paths/~1payins/post/parameters/0` (unresolved $ref)
- `#/paths/~1payins/parameters/0` (unresolved $ref)

## Request body

- PayinRefundRequest
  - `payin_id` string, required: Payin id to be refunded.
  - `amount` integer: Amount in cents. Isn't required for credit card refund.

## Response `200`

OK

- PayinRefundResponse
  - `id` string, uuid
  - `payin_id` string, uuid
  - `amount` integer
  - `status` 'pending' | 'succeeded' | 'failed'
  - `error` object, nullable
    - `code` string
    - `message` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/transfeera/apis/recebimentos.md) - [All operations](https://skmtc.dev/transfeera/apis/recebimentos/llms.txt) - [OpenAPI document](https://skmtc.dev/transfeera/apis/recebimentos/revisions/4dc648d67cb1?raw)