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

# Exemplos

> Prompts e fluxos prontos para usar com o WovePay MCP Server

## Testar API key

```text theme={null}
Use debug_api_key para verificar se minha API key WovePay está funcionando.
```

## Criar cobrança PIX

```text theme={null}
Crie uma cobrança PIX de R$ 49,90 com:
- description: "Assinatura mensal"
- externalReference: "sub_user_123"
- coverFee: false

Use createPaymentPix e mostre o QR code retornado.
```

## Configurar webhook

```text theme={null}
Configure um webhook WovePay com configure_webhook:
- url: https://meusite.com/webhooks/WovePay
- events: payment.paid, payment.created, payment.failed

Guarde o secret retornado e mostre como validar x-WovePay-signature.
```

## Checkout completo

```text theme={null}
Use create_checkout para:
- productName: "Curso WovePay"
- price: 197
- description: "Acesso vitalício"

Retorne a URL de checkout.
```

## Consultar saldo e extrato

```text theme={null}
1. getAccountBalance para ver saldo disponível
2. listPaymentPix com paginate:true e maxPages:3 para últimas cobranças
```

## Analisar webhook recebido

```text theme={null}
Use analyze_webhook com este payload:
{"event":"payment.paid","data":{"id":"pay_abc","amount":100,"status":"PAID"}}

Explique cada campo e mostre código Node.js para validar HMAC.
```

## Discovery de API

```text theme={null}
1. search_operations query="refund"
2. get_operation para o operationId encontrado
3. execute_operation com body de exemplo
```

## Bot Discord com WebSocket

```text theme={null}
Tenho um bot Discord de venda de cargo VIP. Use recommend_integration_mode com platform=discord.
Leia WovePay://bots-playbook e implemente:
1. createPaymentPix com externalReference discord:{guildId}:{orderId}
2. WebSocket wss://ws.WovePay.com.br/v1 subscribe payment.*
3. Liberar cargo no payment.paid + ack
```

## Bot Telegram

```text theme={null}
Use o prompt bot-telegram-payment para integrar PIX no meu bot Telegram.
Busque search_docs topic=websocket e topic=bot.
```

## Webhook vs WebSocket

```text theme={null}
Meu projeto é um worker Python sem URL pública. Devo usar webhook ou WebSocket?
Chame recommend_integration_mode e explique os passos.
```

## JSONs de referência

O resource `WovePay://examples` inclui samples:

| Arquivo                    | Uso                           |
| -------------------------- | ----------------------------- |
| `pix-create.json`          | Cobrança PIX básica           |
| `refund.json`              | Reembolso parcial             |
| `split.json`               | Split interno                 |
| `checkout.json`            | Dados para create\_checkout   |
| `bot-discord-payment.json` | Fluxo bot Discord + WebSocket |