> ## 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.

# Receber os webhooks

> Cria a rota que recebe os avisos da WyzeCash, confere a assinatura e trata cada evento.

> [!NOTE]
>
> Funciona sem chave: a IA lê a documentação e escreve o código no seu projeto.

## Eventos recebidos

| Evento | Para quê |
| - | - |
| `payment.paid` · `payment.expired` · `payment.refunded` | cobranças |
| `withdrawal.completed` · `withdrawal.failed` | saques |
| `subaccount.credited` · `subaccount.debited` | subcontas |

## Prompt

```text theme={null}
Crie no meu sistema, em Node.js, a rota POST que recebe os webhooks da WyzeCash. Use `buscar_documentacao` com `webhooks` para ver os eventos e a assinatura. Leia o corpo cru, confira o X-Bukio-Signature (HMAC-SHA256 de "<t>.<corpo>", recusando t com mais de 5 minutos), responda 2xx em até 10 segundos, guarde o `id` do evento para ignorar repetidos e trate `payment.paid`, `payment.expired` e `payment.refunded`; se o sistema fizer saques, também `withdrawal.completed` e `withdrawal.failed`. O segredo vem da variável de ambiente BUKIOPAY_WEBHOOK_SECRET.
```

Troque `Node.js` pela linguagem do seu projeto.

## Como chamar

| IA | Como |
| - | - |
| Claude Code | `/mcp__bukiopay__configurar-webhook` |
| VS Code | `/mcp.bukiopay.configurar-webhook` |
| Cursor, Codex e Claude Desktop | Copie o prompt acima e cole no chat |

## Parâmetros

| Parâmetro | O que é |
| - | - |
| `linguagem` | A linguagem ou o framework do projeto (ex.: Node.js, PHP, Python). |


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