Evento de saque PIX atualizado

Quando o status de um saque PIX é atualizado internamente (transições de status, processamento pelo provedor, etc.), você receberá um webhook com o evento pix.withdraw.updated contendo as informações da transação.

🏗️ Estrutura do Payload

🔑 Campos Principais

Campo	Tipo	Descrição
`data.event`	string	Tipo do evento (`pix.withdraw.updated`)
`data.data`	object	Dados específicos da transação PIX atualizada
`id`	string	ID único do evento webhook
`apiKeyId`	string	ID da chave API que gerou o evento
`eventType`	string	Tipo do evento (igual a `data.event`)
`timestamp`	number	Timestamp Unix do evento

💰 Dados da Transação PIX

Campo	Tipo	Descrição
`id`	string	🆔 ID único do PIX
`uuid`	string	🔑 UUID secundário da transação
`amount`	number	💵 Valor da transação (em centavos)
`status`	string	📊 Novo status da transação
`type`	string	📤 Tipo da transação (`WITHDRAW`)
`pixKeyType`	string	🔑 Tipo da chave PIX (`CNPJ`, `CPF`, `EMAIL`, `PHONE`, `RANDOM`)
`pixKey`	string	🎫 Chave PIX destino
`e2e`	string	🔗 ID end-to-end da transação PIX
`description`	string	📝 Descrição da transação
`providerReferenceId`	string	🏢 ID de referência do provedor
`createdAt`	string	📅 Data/hora de criação (ISO 8601)
`updatedAt`	string	🔄 Data/hora de atualização (ISO 8601)
`userId`	string	👤 ID do usuário que solicitou o saque
`tenantId`	string	🏢 ID do tenant/organização
`timestamp`	string	🕐 Timestamp do evento (ISO 8601)

📝 Exemplo de Payload Completo

{
  "data": {
    "event": "pix.withdraw.updated",
    "data": {
      "pix": {
        "id": "88eecafb-df8a-4dc9-acd7-438e120e889c",
        "userId": "d0d75271-d641-4c10-a765-69b96c15f4a9",
        "tenantId": "9a43ae9c-d7f2-43c6-a7d4-8706705e3d45",
        "uuid": "78147c97-abf3-4272-8256-84d94e5f6613",
        "pixKey": "12345678000199",
        "e2e": "E1234567820250814220012487ABCDE",
        "pixKeyType": "CNPJ",
        "type": "WITHDRAW",
        "amount": 500,
        "description": "Saque PIX para empresa exemplo",
        "status": "PROCESSING",
        "providerReferenceId": "420026832",
        "createdAt": "2025-08-14T22:00:12.488Z",
        "updatedAt": "2025-08-14T22:01:15.836Z"
      },
      "timestamp": "2025-08-14T22:01:15.846Z"
    }
  },
  "id": "e27d27f9-ae26-4dc6-9d22-9294d7aac034",
  "apiKeyId": "0dd769bb-5e41-41c4-b8c2-6ec972914650",
  "eventType": "pix.withdraw.updated",
  "timestamp": 1755208815854
}

Evento de saque PIX iniciado

Evento de saque PIX concluído