Skip to main content
Para implementar os serviços do E-Consignado, você precisa configurar uma URL para receber os eventos via webhook. Esta configuração permite que a Wincred notifique seu sistema automaticamente sobre mudanças de status e atualizações importantes.

​
Requisitos de Configuração

Para configurar seus webhooks, você precisa:
1

Desenvolver uma URL para recebimento

Crie um endpoint em seu sistema que esteja preparado para receber requisições HTTP do tipo POST, a Wincred enviará os eventos para essa URL, com o tipo do evento no Header e o payload no corpo da requisição.
2

Configurar ambientes separados

Defina URLs distintas para homologação (testes) e produção (operação real)
3

Implementar autenticação

Escolha um método de autenticação aceito pela Wincred para garantir a segurança das comunicações
4

Informar as credenciais à Wincred

Envie as informações da URL e do método de autenticação escolhido para a equipe da Wincred

​
1. URL do Webhook

Você deve desenvolver um endpoint público que receberá as notificações via webhook. Este endpoint será utilizado para a comunicação entre seu sistema e a Wincred através de eventos automáticos. Exemplo de estrutura:

​
2. Ambientes

É essencial configurar URLs diferentes para cada ambiente. Isso garante que os testes não interfiram com dados de produção e vice-versa.

​
Ambiente de Homologação (Desenvolvimento e Testes)

O ambiente de homologação deve ser usado durante todo o processo de desenvolvimento e testes da sua integração. Características:
  • Dados fictícios e de teste
  • Sem impacto em operações reais
  • Ideal para validar sua implementação
Exemplo de URL:
ou

​
3. Método de Chamada

Todos os webhooks da Wincred utilizam o método HTTP POST para enviar as notificações. Seu endpoint deve estar preparado para:
  • Aceitar requisições POST
  • Processar os headers enviados
  • Processar o payload JSON no corpo da requisição
  • Retornar uma resposta HTTP apropriada (idealmente 200 OK)

​
4. Autenticação

Para garantir a segurança das comunicações, você deve definir um método de autenticação. A Wincred suporta os seguintes métodos:
Recomendamos o uso de Bearer Token ou JWT para maior segurança e facilidade de implementação.

​
Como funciona

  1. Você escolhe um método de autenticação da tabela acima
  2. Gera as credenciais necessárias (token, API key, etc.)
  3. Implementa a validação dessas credenciais em seu endpoint
  4. Informa o método escolhido e as credenciais para a equipe da Wincred
  5. A Wincred configura o sistema para incluir a autenticação em cada webhook enviado

​
Enviando suas Credenciais

Após configurar seus endpoints e definir o método de autenticação, você deve enviar as informações para a equipe de integração da Wincred.

​
Email de Configuração

Envie um email para integracoes@wincred.digital com as seguintes informações: