> This page is for BaaS.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://en.docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://en.docs.api.corpx.com/_mcp/server.

# pix.refund.received

POST 

Recebedor de PIX out devolveu o valor por iniciativa própria

Enviado quando o **recebedor** de um PIX out devolve o valor por iniciativa própria (sem que tenhamos pedido). Difere de `pix.refund.completed`, que confirma um refund que **nós** disparamos.

**Estrutura do `data`:**

* `transactionId`: ID determinístico da row do refund recebido (`pix-refund-received-{refundEndToEnd}`).
* `refundEndToEnd`: D-code do refund (BACEN).
* `originalEndToEnd`: E-code do PIX out original que está sendo revertido.
* `originalIdentifier`: Identifier do PIX out original (eco do que foi enviado na criação do pagamento), quando disponível.
* `accountId` / `tenantId`: A conta que recebeu o refund.
* `amount`: Valor revertido.
* `description`: Descrição vinda do partner.
* `receivedAt`: Timestamp do refund.
* `payer`: Quem devolveu o valor (contraparte / recebedor original do PIX out): nome, documento, banco, agência, conta.
* `payee`: Quem recebeu o crédito (nossa conta / pagador original do PIX out): nome, documento, banco, agência, conta.
* `status`: Sempre `"SUCCESS"`.

Reference: https://en.docs.api.corpx.com/baas/referencia/webhook-events/webhook-pix-refund-received

## Request

### Headers

- `X-Signature` (string, optional) — Present when the subscription uses `authType: HMAC`: `base64(HMAC_SHA256(secret, raw_request_body))` (standard Base64, with padding). Compare in constant time against your own computation over the raw body.

### Payload

- `id` (string, required) — Deterministic event id. Same `id` means the same event, possibly redelivered — deduplicate on it.
- `type` (enum, required) — Event type. Full list at `GET /v1/webhooks/events`.
  - Allowed values: `pix.refund.received`
- `occurredAt` (datetime, required) — RFC 3339, UTC with `Z`.
- `schemaVersion` (string, required) — `1.0` today; bumped only on breaking payload changes.
- `environment` (enum, required) — Environment that emitted the event.
  - Allowed values: `production`, `sandbox`
- `tenantId` (string, required) — Tenant the event belongs to.
- `data` (WebhooksWebhookPixRefundReceivedPayloadContentApplicationJsonSchemaData, required) — Event-specific payload. See each webhook.
- `accountId` (string, optional) — CorpX account where the event happened. Empty on cross-account events.

## Types

### WebhooksWebhookPixRefundReceivedPayloadContentApplicationJsonSchemaData

Event-specific payload. See each webhook.

- `transactionId` (string, optional)
- `refundEndToEnd` (string, optional)
- `originalEndToEnd` (string, optional)
- `originalIdentifier` (string, optional)
- `accountId` (string, optional)
- `tenantId` (string, optional)
- `amount` (double, optional)
- `description` (string, optional)
- `receivedAt` (datetime, optional)
- `payer` (WebhooksWebhookPixRefundReceivedPayloadContentApplicationJsonSchemaDataPayer, optional)
- `payee` (WebhooksWebhookPixRefundReceivedPayloadContentApplicationJsonSchemaDataPayee, optional)
- `status` (string, optional)

### WebhooksWebhookPixRefundReceivedPayloadContentApplicationJsonSchemaDataPayer

- `name` (string, optional)
- `document` (string, optional)
- `bankCode` (string, optional)
- `bankIspb` (string, optional)
- `branch` (string, optional)
- `accountNumber` (string, optional)

### WebhooksWebhookPixRefundReceivedPayloadContentApplicationJsonSchemaDataPayee

- `name` (string, optional)
- `document` (string, optional)
- `bankCode` (string, optional)
- `bankIspb` (string, optional)
- `branch` (string, optional)
- `accountNumber` (string, optional)