> This page is for Internet banking (beta).

> 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.in.completed

POST 

PIX recebido com sucesso

Enviado quando um PIX é recebido com sucesso (entrada) na conta. O `id` do envelope é `pix-in-{endToEnd}`.

**Campos sempre presentes em `data`:**

* `transactionId`: ID da transação no nosso sistema.
* `endToEnd`: ID E2E do BACEN.
* `accountId` / `tenantId`
* `amount`: valor em reais.
* `description`: descrição (pode ser vazia).
* `method`: `STATIC_QR_CODE`, `DYNAMIC_QR_CODE` ou `DICT`.
* `receivedAt`: RFC 3339 UTC (`Z`).
* `status`: `"SUCCESS"`.

**Campos condicionais:**

* `identifier`: txid do QR quando o crédito veio de um QR Code.
* `payer` / `payee`: só entram chaves com valor (`name`, `document`, `bankCode`, `bankIspb`, `branch`, `account`, `accountNumber`, `pixKey`). Quando a conta existe, `account` e `accountNumber` repetem o mesmo valor.

Este evento **não** envia `reconciliationId` nem `currency`.

Reference: https://en.docs.api.corpx.com/ib/referencia/webhook-events/webhook-pix-in-completed

## 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.in.completed`
- `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` (WebhooksWebhookPixInCompletedPayloadContentApplicationJsonSchemaData, required) — Event-specific payload. See each webhook.
- `accountId` (string, optional) — CorpX account where the event happened. Empty on cross-account events.

## Types

### WebhooksWebhookPixInCompletedPayloadContentApplicationJsonSchemaData

Event-specific payload. See each webhook.

- `transactionId` (string, optional)
- `endToEnd` (string, optional)
- `accountId` (string, optional)
- `tenantId` (string, optional)
- `amount` (double, optional)
- `description` (string, optional)
- `identifier` (string, optional)
- `method` (string, optional)
- `status` (string, optional)
- `receivedAt` (datetime, optional)
- `payer` (WebhooksWebhookPixInCompletedPayloadContentApplicationJsonSchemaDataPayer, optional)
- `payee` (WebhooksWebhookPixInCompletedPayloadContentApplicationJsonSchemaDataPayee, optional)

### WebhooksWebhookPixInCompletedPayloadContentApplicationJsonSchemaDataPayer

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

### WebhooksWebhookPixInCompletedPayloadContentApplicationJsonSchemaDataPayee

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