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

CampoTipoDescrição
idstringIdentificação única do evento disparado
versionstringVersão do payload que está sendo enviado
timestampstringData/Hora do envio do evento
operation_idintID da Conta
statusbooleanStatus da conta
amountstringValor da operação
external_idstringID externa de identificação da operação
typestringTipo do evento
signaturestringAssinatura 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

CampoTipoDescrição
idstringIdentificação única do evento disparado
versionstringVersão do payload que está sendo enviado
timestampstringData/Hora do envio do evento
operation_idintID da Conta
statusbooleanStatus da conta
amountstringValor da operação
external_idstringID externa de identificação da operação
detailsarrayDetalhes da operação de resgate contendo as notas resgatadas
details.ticket_idintID do ticket vinculado a aplicação que foi resgatada
details.application_external_idstringID externo de identificação da aplicação resgatada
details.quotas_quantitystringQuantidade cotas
details.amountstringValor líquido
details.iofstringValor do IOF
details.irstringValor do IR
typestringTipo do evento
signaturestringAssinatura 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

CampoTipoDescrição
idstringIdentificação única do evento disparado
versionstringVersão do payload que está sendo enviado
timestampstringData/Hora do envio do evento
amountstringValor da operação
ticket_idintID do ticket
external_idstringID externo de identificação da aplicação do ticket
quota_datearrayData da cota
blocked_quantityintQuantidade de cotas bloqueadas
quotas_quantitystringQuantidade de cotas
gross_balancestringValor bruto
estimated_irstringValor estimado do IR
estimated_iofstringValor estimado do IOF
net_balancestringValor líquido
typestringTipo do evento
signaturestringAssinatura 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.