Renda Fixa
Os eventos relacionados a aplicações, resgates e atualizações de notas de Renda Fixa são disparados automaticamente pelo sistema durante cada etapa do processamento.
Aplicação de Renda Fixa
Após a criação de uma nova aplicação de Renda Fixa, durante cada etapa da aplicação até sua finalização é enviada uma notificação com os dados no seguinte formato abaixo para o webhook que foi configurado para o recebimento deste tipo de evento, para mais informações consulte Renda Fixa.
📋 Estrutura do Payload
{
"payload":{
"id":"6ee2e82a-681e-4f88-8a4f-85240c313fbb",
"version":"1.0",
"timestamp":"2025-06-05 18:26:04.536927",
"data":{
"operation_id":500000,
"status":"done",
"amount":"50.00",
"external_id":"4e6c6e4e9bca948eb4e8aad7a4052977ced462e40508d82aead276d72950086b"
},
"type":"application_update"
},
"signature":"MGUCMQDlwPBWd0DJZ1U4ymGePkVFfkie8/lieZmmcaFT1Rc3C5XZIwobazGDZDVdf0wK6VgCMEmbqwQIiZR+mV3zJcDa9hRFAiPTkssmKLn5A/nFsvoK/6Ul76GAECG8kCh6nDHlVw=="
}🔍 Campos do Payload
| Campo | Tipo | Descrição |
|---|---|---|
| id | string | Identificação única do evento disparado |
| version | string | Versão do payload que está sendo enviado |
| timestamp | string | Data/Hora do envio do evento |
| operation_id | int | ID da Conta |
| status | boolean | Status da conta |
| amount | string | Valor da operação |
| external_id | string | ID externa de identificação da operação |
| type | string | Tipo do evento |
| signature | string | Assinatura do evento, deve ser usado junto com o certificado público para validação do evento |
Resgates de Renda Fixa
Após a criação de um novo resgate de Renda Fixa, durante cada etapa do resgate até sua finalização é enviada uma notificação com os dados no seguinte formato abaixo para o webhook que foi configurado para o recebimento deste tipo de evento, para mais informações consulte Renda Fixa.
📋 Estrutura do Payload
{
"payload":{
"id":"117173a5-b162-4ddb-ac3e-81ff812d555f",
"version":"1.0",
"timestamp":"2025-06-09 11:57:06.231179",
"data":{
"status":"done",
"amount":"993.89",
"operation_id":1490451,
"external_id":"41ec5903-85c7-42fc-85cf-801fc7288885",
"details":[
{
"ticket_id":1948119,
"application_external_id":"09c7a994-27ef-4af9-88ee-ab3c2e64cb66",
"quotas_quantity":"376.935435810000",
"amount":"473.44",
"iof":"0.00",
"ir":"3.59"
}
]
},
"type":"retrieval_update"
},
"signature":"MGQCMCcanRWrrp2uIGKpOudo+S55hxNwIwdOwpeTsIi+EchLxqNuXSjcVbia54Qe73sdnwIwO8Pw86y7DaSpjJfKIrBaY2MqpGDuS3OdG6Os+bNaeo/360ClnH2sy7Y0i9yCiF2u"
}🔍 Campos do Payload
| Campo | Tipo | Descrição |
|---|---|---|
| id | string | Identificação única do evento disparado |
| version | string | Versão do payload que está sendo enviado |
| timestamp | string | Data/Hora do envio do evento |
| operation_id | int | ID da Conta |
| status | boolean | Status da conta |
| amount | string | Valor da operação |
| external_id | string | ID externa de identificação da operação |
| details | array | Detalhes da operação de resgate contendo as notas resgatadas |
| details.ticket_id | int | ID do ticket vinculado a aplicação que foi resgatada |
| details.application_external_id | string | ID externo de identificação da aplicação resgatada |
| details.quotas_quantity | string | Quantidade cotas |
| details.amount | string | Valor líquido |
| details.iof | string | Valor do IOF |
| details.ir | string | Valor do IR |
| type | string | Tipo do evento |
| signature | string | Assinatura do evento, deve ser usado junto com o certificado público para validação do evento |
Atualizações de Notas
A cada atualização de notas de Fundos, é enviada uma notificação com os dados no seguinte formato abaixo para o webhook que foi configurado para o recebimento deste tipo de evento.
📋 Estrutura do Payload
{
"payload":{
"id":"fbd452dc-d989-4b19-b93a-3f5619818c05",
"version":"1.0",
"timestamp":"2025-06-09 12:06:55.139338",
"data":{
"amount":"10000.00",
"ticket_id":2847751,
"external_id":"aee7fc1c-3ce5-4de4-859d-dc053818984f",
"quota_date":"2025-06-06",
"blocked_quantity":"0",
"quotas_quantity":"5144.356736470000",
"gross_balance":"7428.26",
"estimated_ir":"25.93",
"estimated_iof":"0.00",
"net_balance":"7402.33"
},
"type":"ticket_update"
},
"signature":"MGYCMQDziPs7F3u5QSDYCsn3tUGYn2AQ8iKZc6Lq6fKp0im69EYqTEOS/KMHgROKt5FO27cCMQD72PWUwyDYMUb73ktsAJkQ3JAzprG8aTratxP9mbJ1h5zjhYsy+O+Q/Fw+wgSLbMk="
}🔍 Campos do Payload
| Campo | Tipo | Descrição |
|---|---|---|
| id | string | Identificação única do evento disparado |
| version | string | Versão do payload que está sendo enviado |
| timestamp | string | Data/Hora do envio do evento |
| amount | string | Valor da operação |
| ticket_id | int | ID do ticket |
| external_id | string | ID externo de identificação da aplicação do ticket |
| quota_date | array | Data da cota |
| blocked_quantity | int | Quantidade de cotas bloqueadas |
| quotas_quantity | string | Quantidade de cotas |
| gross_balance | string | Valor bruto |
| estimated_ir | string | Valor estimado do IR |
| estimated_iof | string | Valor estimado do IOF |
| net_balance | string | Valor líquido |
| type | string | Tipo do evento |
| signature | string | Assinatura do evento, deve ser usado junto com o certificado público para validação do evento |
Validação e Processamento
Verifique a assinatura usando o certificado público.
Atualize seus registros com os dados recebidos.
Monitore os status para garantir o processamento correto.
