API Reference

Notification Management

The CDC bank sends notification webhooks to communicate events such as received pix transfers and many other events. You can check the complete list of webhooks notification events below.

The CDC will send HTTP POST requests to a specified URL endpoint hosted in your environment and configured to receive and process them.

📘

To start using CDC's webhooks, you will need to:

  1. Expose an endpoint on your server
  2. Register your endpoint and the events you would like to subscribe
  3. Process CDC's notifications

Retry Logic

The CDC uses at-least-once delivery to ensure that your application has received a notification. If your application has not acknowledged a message within 7 seconds, we will keep sending the request until it is accepted.

📘

Retry attempts will happen regularly, at increasing time intervals:

The attempts happen in intervals of 500ms at first, but increase by 40% each time the request is not successful, until a max of 5 retries

Your webhook endpoint might occasionally receive the same notification more than once. You can handle these cases by making your event processing idempotent using the unique code field for every event.

Webhook templates

This is a list of all possible webhooks templates


Receive Pix

{
   "pix":[
      {
         "endToEndId":"E88204963202412041258341052B2485",
         "txid":"1EB88B8AD0B94F0F90594C8F3E14C9D9",
         "valor":"10.00",
         "chave":"eb228190-f88c-4e87-b64f-22e219d2c3dc",
         "componentesValor":{
            "original":{
               "valor":"100.00"
            }
         },
         "horario":"2024-12-04T12:59:33.478Z",
         "infoPagador":"Teste de mensagem",
         "devolucoes":[
            {
               "id":"123456",
               "rtrId":"D12345678202009091000abcde123456",
               "valor":"7.89",
               "horario":{
                  "solicitacao":"2020-09-11T15:25:59.411Z"
               },
               "status":"EM_PROCESSAMENTO"
            }
         ]
      }
   ]
}