API 端点Webhooks
创建 Webhook
认证
BearerAuth 认证Bearer <token>
位置: header
请求体
application/json
TypeScript 类型定义
在 TypeScript 中使用 request body 类型。
响应体
application/json
application/json
application/json
curl -X POST "https://api.exemplo.processamento.com/v1/user/webhooks" \ -H "Content-Type: application/json" \ -d '{ "url": "https://seusite.com.br/webhooks/pix", "generateSecret": true }'{
"id": "kx7m2p9q4r8t1v5w3y6z0a2b",
"url": "https://seusite.com.br/webhooks/pix",
"active": true,
"events": [
"TRANSACTION_COMPLETED",
"TRANSACTION_REFUNDED"
],
"hasSecret": true,
"createdAt": "2026-05-06T13:45:12.000Z",
"updatedAt": "2026-05-06T13:45:12.000Z",
"secret": "B9tQ2sX7yLp4NcVw1mZk8rHgJd0fEaUoTiRbSnYxQvM"
}{
"statusCode": 400,
"error": "Bad Request",
"message": "Validation failed",
"requestId": "cmou00000abcdef01s6ghij1k2lm"
}{
"statusCode": 409,
"error": "Conflict",
"message": "Limite de 5 webhooks ativos atingido",
"requestId": "cmou00000abcdef01s6ghij1k2lm"
}