Skip to navigation

pix.out.timeout

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.

Headers

X-SignaturestringOptional

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

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