Update Configuration

PUT {{url_contbank}}/partner-bff/s2s/webhooks/configuration/:id

Atualizar Configuração de Webhook

Essa funcionalidade permite atualizar uma configuração de webhook existente com novos parâmetros, como URLs de destino e cabeçalhos de autorização. Para realizar essa operação, é necessário fornecer o ID da configuração que deseja atualizar.

Request Schema

CampoDescrição
contextIndica o segmento que o webhook será configurado. Use BILLINGS para receber eventos relacionados a boletos.
event_nameDefine o tipo de evento para o qual o webhook será configurado. Opções disponíveis: CREATED, UPDATED, CANCELED, PAID_OUT.
methodMétodo HTTP esperado para a notificação (ex: POST).
urlURL de destino para receber as notificações.
contingency_urlURL de contingência para notificações em caso de falha na URL principal.
header_authorizationCabeçalhos de autorização necessários para acesso à URL (opcional). (ex. [key:X-token, value:valor da chave] )

Response Schema

CampoDescrição
idID único da configuração do webhook.
partner_idID do parceiro associado à configuração.
contextIndica o segmento que o webhook está configurado. Use BILLINGS para eventos relacionados a boletos.
event_nameTipo de evento para o qual o webhook está configurado.
methodMétodo HTTP esperado para a notificação (ex: POST).
urlURL de destino para receber as notificações.
contingency_urlURL de contingência para notificações em caso de falha na URL principal.
activeIndica se a configuração está ativa (true) ou não (false).
created_atData e hora de criação da configuração.
created_byID do usuário que criou a configuração.
updated_atData e hora da última atualização da configuração.
updated_byID do usuário responsável pela última atualização, se aplicável.
header_authorizationCabeçalhos de autorização necessários para acesso à URL (opcional).
request_idID da requisição associada à configuração do webhook.

Request Body

{"context"=>"BILLINGS", "event_name"=>"CREATED", "method"=>"POST", "url"=>"https://seudominio.com.br/suarotanova", "contingency_url"=>"https://seudominio.com.br/contigencia/suarotanova", "header_authorization"=>[{"key"=>"X-Client-ID", "value"=>"username123"}, {"key"=>"X-Client-Secret", "value"=>"password123"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring