Pix ProcessamentoPix Processamento Docs
Endpoints da APIWebhooks

Criar webhook

POST
/user/webhooks

Autorização

BearerAuth
AutorizaçãoBearer <token>

Em: header

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

Corpo da resposta

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"
}