Improved
Identificação da origem de conta em Webhooks V3
January 5th, 2026
Para facilitar a conciliação de eventos em ecossistemas de subcontas, adicionamos o objeto account no payload de todos os eventos de webhooks da API V3. Anteriormente, a identificação da subconta de origem dependia de parametrização manual da URL de destino. Com esta atualização, o ID da conta que gerou o evento passa a ser enviado nativamente no corpo do JSON.
O que mudou:
- Adição da propriedade raiz
account. - Propriedade
account.id: Identificador único da conta que disparou o evento. - Propriedade
account.ownerId: Identificador único da conta pai (retorna null para contas raízes).
Exemplo de Payload:
{
"id": "evt_05b708f961d739ea7eba7e4db318f621&368604920",
"event": "PAYMENT_RECEIVED",
"dateCreated": "2026-01-05 16:45:03",
"account": {
"id": "1fcc491f-96d9-4efe-8ec5-b8b09de750dd",
"ownerId": "034edb54-d54f-4fd9-9258-afa5491b906a"
},
"payment": { ... }
}