> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delfinance.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar devoluções de um repasse

> Consulte as devoluções de um repasse e o status de cada Pix de devolução.

> [!WARNING]
>
> **Funcionalidade em beta.** Contrato em proposta, sujeito a mudanças. Veja o guia [Acompanhar repasses](https://docs.delfinance.com.br/guias/split-pagamentos/acompanhar-repasses.md).

Retorna todas as devoluções (*refunds*) de um repasse (*payout*), da mais recente para a mais antiga. Use para acompanhar o resultado de cada Pix de devolução criado em [Devolver parte de um repasse](https://docs.delfinance.com.br/api-reference/split-pagamentos/devolver-repasse.md).

As devoluções também vêm no campo `refunds` de cada repasse em [Consultar ordem de recebimento com split](https://docs.delfinance.com.br/api-reference/split-pagamentos/consultar-recebimento.md).

## Headers

**x-delbank-api-key** `string` *required*

Sua API key.

**x-delfinance-account-id** `string` *required*

Número da conta de recebimento.

## Path params

**payoutId** `string` *required*

Identificador do repasse (`id`).

## Response

Array de devoluções, sem paginação. Um repasse vazio retorna `[]`.

Cada item tem a estrutura descrita em [Devolver parte de um repasse](https://docs.delfinance.com.br/api-reference/split-pagamentos/devolver-repasse.md#response): `id`, `payoutId`, `amount`, `status`, `reason`, `requestedBy`, `transactionId`, `endToEndId`, `errorMessage`, `createdAt` e `updatedAt`.

| Status da devolução (`name`) | Significado |
| - | - |
| `PROCESSING` | Pix de devolução enviado, aguardando confirmação. O valor já foi descontado do repasse |
| `SUCCESS` | Valor devolvido ao cliente final |
| `ERROR` | Devolução não concluída. O motivo vem em `errorMessage`, e o valor volta para o `amount` do repasse |

## Erros

| HTTP | Código | Quando acontece |
| - | - | - |
| `404` | `SPLIT_PAYOUT_NOT_FOUND` | Não existe repasse com esse `payoutId` na conta de recebimento |

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/payouts/3f9b2c7e-8d14-4b6a-a0e5-71c2d9f4b8a3/refunds' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
```

```json 200 theme={null}
[
    {
        "id": "9a7b6c5d-4e3f-4a2b-8c1d-0e9f8a7b6c5d",
        "payoutId": "3f9b2c7e-8d14-4b6a-a0e5-71c2d9f4b8a3",
        "amount": 30.00,
        "status": {
            "name": "SUCCESS",
            "description": "Sucesso",
            "value": 1
        },
        "reason": "Devolução de 1 item do pedido 4821",
        "requestedBy": "Equipe financeira",
        "transactionId": "d4c3b2a1-f6e5-4d7c-9b8a-7f6e5d4c3b2a",
        "endToEndId": "D38224857202611031305abcdef654321",
        "errorMessage": null,
        "createdAt": "2026-11-03T13:05:00.000Z",
        "updatedAt": "2026-11-03T13:05:04.000Z"
    }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.