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

# Webhook de saque

> Payload e status enviados nos webhooks de transferências

## Webhook de saque

Sempre que ocorre uma mudança de status em uma transferência (saque), a Pluggou envia um webhook para todos os endpoints ativos cadastrados na sua conta. Para entender o funcionamento geral dos webhooks (headers, segurança, tempo limite, retentativas e idempotência), consulte o [guia geral de Webhooks](/api-reference/webhooks).

***

## Exemplo de webhook recebido

```bash theme={null}
curl -X POST https://seusite.com/webhook \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Event-ID: b2c3d4e5-f6a1-7890-bcde-234567890abc" \
  -H "X-Webhook-Code: whk_a8Kd92mNx7Pq3rT5vW1yZ0bC4eF6gH8jL0mN2pR4tV6x" \
  -H "User-Agent: Pluggou-Webhook/1.0" \
  -d '{
    "id": "d4e5f6a1-b2c3-7890-defg-34567890abcd",
    "event_type": "withdrawal",
    "data": {
        "id": "e5f6a1b2-c3d4-7890-efgh-4567890abcde",
        "e2e_id": "E12345678202301011234abcdefghijkl",
        "amount": 50000,
        "liquid_amount": 50000,
        "pix_type": "cpf",
        "pix_key": "12345678909",
        "status": "paid",
        "paid_at": "2026-01-29 15:00:00",
        "created_at": "2026-01-29 14:58:00"
    }
  }'
```

***

## Campos do payload

| Campo                | Tipo           | Descrição                                                                                                          |
| -------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------ |
| `id`                 | string (UUID)  | Identificador único deste evento de webhook.                                                                       |
| `event_type`         | string         | Sempre `"withdrawal"` para webhooks de saque.                                                                      |
| `data.id`            | string (UUID)  | Identificador único do saque.                                                                                      |
| `data.e2e_id`        | string \| null | Identificador end-to-end do PIX de saída gerado pelo banco. Disponível apenas após a transferência ser processada. |
| `data.amount`        | integer        | Valor total do saque em centavos.                                                                                  |
| `data.liquid_amount` | integer        | Valor líquido transferido em centavos (após taxas de saque, se houver).                                            |
| `data.pix_type`      | string         | Tipo da chave PIX de destino. Valores possíveis: `cpf`, `cnpj`, `email`, `phone`, `random`.                        |
| `data.pix_key`       | string         | Valor da chave PIX de destino do saque.                                                                            |
| `data.status`        | string         | Status atual do saque (veja tabela abaixo).                                                                        |
| `data.paid_at`       | string \| null | Data/hora em que o saque foi efetivado no formato `"YYYY-MM-DD HH:mm:ss"`. `null` se ainda não foi pago.           |
| `data.created_at`    | string         | Data/hora de criação do saque no formato `"YYYY-MM-DD HH:mm:ss"`.                                                  |

***

## Status possíveis

| Status     | Significado                                                                       |
| ---------- | --------------------------------------------------------------------------------- |
| `pending`  | Saque solicitado e aguardando processamento ou aprovação.                         |
| `approved` | Saque aprovado e em processamento pela adquirente.                                |
| `paid`     | Saque efetivado. O valor foi transferido para a chave PIX de destino.             |
| `failed`   | Saque falhou durante o processamento (erro na adquirente, dados inválidos, etc.). |
| `canceled` | Saque cancelado antes de ser processado.                                          |
| `refunded` | Valor do saque estornado e devolvido à carteira do usuário.                       |