pix.out.timeout

{
  "id": "evt_pix_out_timeout_001",
  "type": "pix.out.timeout",
  "occurredAt": "2026-05-04T10:42:11.000Z",
  "schemaVersion": "1.0",
  "environment": "production",
  "tenantId": "tenant-acme",
  "data": {
    "paymentId": "pay_9ccd1869-7593-4feb-9602-e525e818ab8e",
    "transactionId": "162982-pix",
    "accountId": "acc_123456",
    "tenantId": "tenant-acme",
    "endToEnd": "E0000000020260504104211",
    "amount": 250,
    "currency": "BRL",
    "status": "TIMEOUT",
    "errorCode": "confirmation_timeout",
    "errorReason": "tempo de resposta do parceiro estourou. A chamada para enviar o dinheiro foi enviada com sucesso, mas a confirmação final do status ainda não chegou.",
    "error": "tempo de resposta do parceiro estourou. A chamada para enviar o dinheiro foi enviada com sucesso, mas a confirmação final do status ainda não chegou.",
    "warning": "tempo de resposta do parceiro estourou. A chamada para enviar o dinheiro foi enviada com sucesso, mas a confirmação final do status ainda não chegou.",
    "identifier": "order-12345",
    "partnerStatus": "awaiting-authorization",
    "partnerStatusId": 7,
    "hold": {
      "owner": "partner",
      "reason": "partner_authorization"
    }
  },
  "accountId": "acc_123456"
}

Tempo de resposta do parceiro estourou; chamada foi enviada com sucesso

Enviado quando o desfecho da ordem é indeterminado ao fim da janela de confirmação: a chamada ao parceiro foi enviada mas a resposta/confirmação final não chegou a tempo (inclui timeout de comunicação na própria chamada de envio). Não é uma falha definitiva — um pix.out.completed ou pix.out.failed tardio ainda pode chegar depois. Recomendamos verificar o extrato antes de tentar novamente com nova chave de idempotência (re-tentativa com a mesma chave é segura).

Estrutura do data:

paymentId, transactionId, accountId, tenantId: Identificação da operação.
endToEnd: BACEN E2E quando o partner já tinha emitido.
amount / currency: Valor enviado (BRL).
status: Sempre "TIMEOUT".
errorCode / errorReason / warning / error: Orientação do que fazer (confirmation_timeout).
identifier, description, key, payer / payee: quando disponíveis.
hold: Presente quando a ordem ficou retida no banco liquidante. Traz owner: "partner" e reason (partner_authorization = fila de autorização interna do liquidante; partner_risk_analysis = análise de risco; partner_unspecified = retido, sem detalhe da fila). Quando este objeto vem, não há nada a aprovar do seu lado nem do nosso — a decisão é do liquidante.
partnerStatus / partnerStatusId: Retrato bruto do estado no liquidante, para você anexar em ticket. São valores do liquidante, não do nosso vocabulário canônico: não use em comparação de status.

Tempo de resposta do parceiro estourou; chamada foi enviada com sucesso Enviado quando o desfecho da ordem é **indeterminado** ao fim da janela de confirmação: a chamada ao parceiro foi enviada mas a resposta/confirmação final não chegou a tempo (inclui timeout de comunicação na própria chamada de envio). Não é uma falha definitiva — um `pix.out.completed` ou `pix.out.failed` tardio ainda pode chegar depois. Recomendamos verificar o extrato antes de tentar novamente com nova chave de idempotência (re-tentativa com a mesma chave é segura). **Estrutura do `data`:** - `paymentId`, `transactionId`, `accountId`, `tenantId`: Identificação da operação. - `endToEnd`: BACEN E2E quando o partner já tinha emitido. - `amount` / `currency`: Valor enviado (`BRL`). - `status`: Sempre `"TIMEOUT"`. - `errorCode` / `errorReason` / `warning` / `error`: Orientação do que fazer (`confirmation_timeout`). - `identifier`, `description`, `key`, `payer` / `payee`: quando disponíveis. - `hold`: Presente quando a ordem ficou retida **no banco liquidante**. Traz `owner: "partner"` e `reason` (`partner_authorization` = fila de autorização interna do liquidante; `partner_risk_analysis` = análise de risco; `partner_unspecified` = retido, sem detalhe da fila). Quando este objeto vem, **não há nada a aprovar do seu lado nem do nosso** — a decisão é do liquidante. - `partnerStatus` / `partnerStatusId`: Retrato bruto do estado no liquidante, para você anexar em ticket. São valores do liquidante, não do nosso vocabulário canônico: não use em comparação de status.

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

Tempo de resposta do parceiro estourou; chamada foi enviada com sucesso

Estrutura do data:

paymentId, transactionId, accountId, tenantId: Identificação da operação.
endToEnd: BACEN E2E quando o partner já tinha emitido.
amount / currency: Valor enviado (BRL).
status: Sempre "TIMEOUT".
errorCode / errorReason / warning / error: Orientação do que fazer (confirmation_timeout).
identifier, description, key, payer / payee: quando disponíveis.
hold: Presente quando a ordem ficou retida no banco liquidante. Traz owner: "partner" e reason (partner_authorization = fila de autorização interna do liquidante; partner_risk_analysis = análise de risco; partner_unspecified = retido, sem detalhe da fila). Quando este objeto vem, não há nada a aprovar do seu lado nem do nosso — a decisão é do liquidante.
partnerStatus / partnerStatusId: Retrato bruto do estado no liquidante, para você anexar em ticket. São valores do liquidante, não do nosso vocabulário canônico: não use em comparação de status.

Headers

Payload

Response

Headers

Payload

Response