policy.violation

Uma regra de policy foi violada — pagamento recusado (action BLOCK) ou apenas avisado (action NOTIFY_ONLY)

Uma regra de política configurada para a sua conta ou tenant foi violada. O evento cobre todas as seções de política — PIX out, PIX in, QR Code, chaves e estorno — e é enviado tanto quando a operação é recusada (action: "BLOCK") quanto quando ela apenas gera aviso (NOTIFY_ONLY no modo monitor, ALLOW_AND_NOTIFY e AUTO_REFUND em PIX recebido). Use blocked para distinguir sem interpretar a ação.

Uma regra de policy foi violada — pagamento recusado (action BLOCK) ou apenas avisado (action NOTIFY_ONLY) Uma regra de política configurada para a sua conta ou tenant foi violada. O evento cobre todas as seções de política — PIX out, PIX in, QR Code, chaves e estorno — e é enviado tanto quando a operação é **recusada** (`action: "BLOCK"`) quanto quando ela apenas **gera aviso** (`NOTIFY_ONLY` no modo monitor, `ALLOW_AND_NOTIFY` e `AUTO_REFUND` em PIX recebido). Use `blocked` para distinguir sem interpretar a ação.

Payload

The payload of this webhook request is an object.

idstringRequired

Deterministic event id. Same id means the same event, possibly redelivered — deduplicate on it.

typeenumRequired

Event type. Full list at GET /v1/webhooks/events.

Allowed values:

occurredAtdatetimeRequired

RFC 3339, UTC with Z.

schemaVersionstringRequired

1.0 today; bumped only on breaking payload changes.

environmentenumRequired

Environment that emitted the event.

Allowed values:

tenantIdstringRequired

Tenant the event belongs to.

dataobjectRequired

Event-specific payload. See each webhook.

accountIdstringOptional

CorpX account where the event happened. Empty on cross-account events.

Response

2XX

Acknowledged. Any 2xx within 10 seconds stops retries; anything else is retried with backoff (see the Webhooks guide).

Headers

Payload

Response

Headers

Payload

Response