Testar API key
Use debug_api_key para verificar se minha API key WovePay está funcionando.
Criar cobrança PIX
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
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
Use create_checkout para:
- productName: "Curso WovePay"
- price: 197
- description: "Acesso vitalício"
Retorne a URL de checkout.
Consultar saldo e extrato
1. getAccountBalance para ver saldo disponível
2. listPaymentPix com paginate:true e maxPages:3 para últimas cobranças
Analisar webhook recebido
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
1. search_operations query="refund"
2. get_operation para o operationId encontrado
3. execute_operation com body de exemplo
Bot Discord com WebSocket
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
Use o prompt bot-telegram-payment para integrar PIX no meu bot Telegram.
Busque search_docs topic=websocket e topic=bot.
Webhook vs WebSocket
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 resourceWovePay://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 |