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

# Transferências

> transfer.received e transfer.sent: transferências entre contas WyzeCash, que são feitas no painel e avisadas pela API.

Transferências entre contas WyzeCash (`TRF-`) são na hora e grátis. Elas são feitas no painel, com o código do app autenticador; pela API você é avisado quando recebe ou envia uma.

| Evento | Quando |
| - | - |
| `transfer.received` | outra conta WyzeCash transferiu para você; o valor já está disponível |
| `transfer.sent` | você transferiu para outra conta WyzeCash |

## Corpo

```json theme={null}
{
  "id": "evt_01JA7XK0Z4B6D8F0H2J4L6N8Q0",
  "type": "transfer.received",
  "created_at": "2026-10-08T15:20:11.090Z",
  "data": { "id": "TRF-6H1N0P2M4Q8W", "amount": 30000, "fee": 0, "senderName": "Carlos M." }
}
```

```json theme={null}
{
  "type": "transfer.sent",
  "data": { "id": "TRF-6H1N0P2M4Q8W", "amount": 30000, "fee": 0, "recipientName": "Ana S." }
}
```

| Campo | O que é |
| - | - |
| `amount` | valor transferido (centavos) |
| `fee` | tarifa (grátis por padrão) |
| `senderName` | quem mandou, abreviado (só em `transfer.received`) |
| `recipientName` | quem recebeu, abreviado (só em `transfer.sent`) |

## O jeito certo de tratar

* `transfer.received` já é dinheiro disponível: não existe etapa de confirmação.
* Os nomes vêm abreviados por privacidade; o extrato (`GET /v1/transactions`) traz o mesmo.
* Dedupe pelo `id` do evento.

## Teste

O botão **Enviar teste** no painel manda `webhook.test` com `data.id` igual a `TESTE`, assinado como qualquer outro evento. Responda `2xx`.


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