pix.in.completed

{
  "id": "pix-in-E0000000020251229211433912",
  "type": "pix.in.completed",
  "occurredAt": "2025-12-29T21:14:33.912Z",
  "schemaVersion": "1.0",
  "environment": "production",
  "tenantId": "tenant-acme",
  "data": {
    "transactionId": "2ee948cb-4e03-43d1-b202-b7fb31d5b016",
    "endToEnd": "E0000000020251229211433912",
    "accountId": "acc_123456",
    "tenantId": "tenant-acme",
    "amount": 150.5,
    "description": "PIX Recebido",
    "identifier": "SEV798c4a1f4b2e4d9c8a1b2c3d4",
    "method": "STATIC_QR_CODE",
    "status": "SUCCESS",
    "receivedAt": "2025-12-29T21:14:33.912Z",
    "payer": {
      "name": "JOAO SILVA",
      "document": "12345678900",
      "bankCode": "001",
      "bankIspb": "00000000",
      "branch": "0001",
      "account": "123456",
      "accountNumber": "123456"
    },
    "payee": {
      "name": "ACME LTDA",
      "document": "12345678000199",
      "bankCode": "208",
      "bankIspb": "50871921",
      "branch": "1",
      "account": "3811084",
      "accountNumber": "3811084"
    }
  },
  "accountId": "acc_123456"
}

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.

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`.

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).

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.

Headers

Payload

Response

Headers

Payload

Response