curl -X POST 'https://api.wovepay.com/v1/webhooks/create' \
-H 'X-API-Key: wp_live_SUA_CHAVE' \
-H 'Content-Type: application/json' \
-d '{ "url": "https://api.suaempresa.com/webhooks/WovePay", "description": "ERP produção", "events": ["payment.paid", "transfer.completed"] }'
{
"success": true,
"message": "Webhook criado com sucesso",
"data": {
"item": {
"id": "clx_webhook",
"url": "https://api.suaempresa.com/webhooks/WovePay",
"description": "ERP produção",
"events": ["payment.paid", "transfer.completed"],
"status": "ACTIVE",
"createdAt": "2026-07-01T12:00:00.000Z"
},
"secret": "whsec_..."
},
"requestId": "req_abc"
}
Endpoints
Cadastrar webhook
Cadastra URL de eventos vinculada à API key.
POST
/
webhooks
/
create
curl -X POST 'https://api.wovepay.com/v1/webhooks/create' \
-H 'X-API-Key: wp_live_SUA_CHAVE' \
-H 'Content-Type: application/json' \
-d '{ "url": "https://api.suaempresa.com/webhooks/WovePay", "description": "ERP produção", "events": ["payment.paid", "transfer.completed"] }'
{
"success": true,
"message": "Webhook criado com sucesso",
"data": {
"item": {
"id": "clx_webhook",
"url": "https://api.suaempresa.com/webhooks/WovePay",
"description": "ERP produção",
"events": ["payment.paid", "transfer.completed"],
"status": "ACTIVE",
"createdAt": "2026-07-01T12:00:00.000Z"
},
"secret": "whsec_..."
},
"requestId": "req_abc"
}
curl -X POST 'https://api.wovepay.com/v1/webhooks/create' \
-H 'X-API-Key: wp_live_SUA_CHAVE' \
-H 'Content-Type: application/json' \
-d '{ "url": "https://api.suaempresa.com/webhooks/WovePay", "description": "ERP produção", "events": ["payment.paid", "transfer.completed"] }'
{
"success": true,
"message": "Webhook criado com sucesso",
"data": {
"item": {
"id": "clx_webhook",
"url": "https://api.suaempresa.com/webhooks/WovePay",
"description": "ERP produção",
"events": ["payment.paid", "transfer.completed"],
"status": "ACTIVE",
"createdAt": "2026-07-01T12:00:00.000Z"
},
"secret": "whsec_..."
},
"requestId": "req_abc"
}
Corpo da requisição
string
required
URL HTTPS pública.
string
required
Nome do endpoint.
array
required
Lista de eventos. Veja o guia Webhooks.
A resposta inclui secret whsec_… exibido uma única vez.
Authorizations
Chave wp_live_... criada em Integrações → Chaves de API no dashboard.
Body
application/json
HTTPS obrigatório.
Maximum string length:
120Required array length:
1 - 80 elementsAvailable options:
payment.created, payment.paid, payment.failed, payment.refunded, payment.pix.expired, payment.crypto.created, payment.crypto.paid, payment.crypto.failed, payment.crypto.expired, transfer.created, transfer.crypto.completed, transfer.crypto.failed, transfer.completed, transfer.failed, med.created, med.updated, med.evidence_sent, webhook.test 
