Giro.Tech
  • Introdução
    • Comece por aqui
    • Sobre a Giro.Tech
    • Produtos da Giro.Tech
      • Bancarização (GTBanker)
        • Ambientes e Autenticação
          • Ambientes
          • Restrição de IPs
          • Headers
        • Lastro da CCB
          • Preenchimento do Contrato e Trilha de Auditoria
          • Modelo de Contrato
          • Trilha de Auditoria
        • Webhooks
          • Sobre
          • Cadastro de Webhook
          • Recomendações
      • Assinatura Eletrônica de Documentos (GTSign)
        • Ambientes e Autenticação
        • API Reference
          • Documentos
            • Criar documento e Signatários
            • Alterar Documento para Pronto para Assinar
            • Cancelar documento
            • Buscar Documentos
            • Buscar Documento por UUID ou Referência
            • Reenvio de email para assinatura
          • Envelopes
            • Criar Envelope
            • Signatários do Envelope
            • Alterar Envelope para pronto para assinar
            • Cancelamento de Envelope
            • Reenvio de notificação para Envelope
          • CCB
            • Criação de CCB e envio para assinatura
          • Webhooks
            • Webhook - Registro
            • Webhook - Consulta
            • Webhook - Eventos
            • Webhook - Deletar
      • Consulta no Sistema de Informações de Créditos (GTSCR)
        • Estrutura dos dados
        • Ambientes e Autenticação
        • Ambiente de Homologação
        • API Reference
          • Consulta no SCR
            • Criar Consulta
            • Consultar Solicitação por Documento
            • Consultar Solicitação por UUID
          • Webhooks
            • Criar Webhook
            • Consultar Webhook
            • Chamada do Webhook
      • Antecipação de Fornecedores (GTFor)
        • Ambientes e Autenticação
        • API Reference
          • Importação de Títulos
          • Conciliação
          • Criação de Fornecedor
    • Conceitos e Glossário
      • O que é CCB?
      • O que é SCD?
      • O que é Bancarização?
      • O que é Securitizadora?
      • O que é FIDC?
      • O que é Subordinada, Mezanino e Sênior?
      • O que é SCR?
      • O que é CDC?
      • O que é CNAB?
      • O que é CP ou EP?
      • O que é DTVM?
      • O que é Cessão da CCB?
      • O que é Termo de Cessão?
      • O que é Seguro Prestamista?
      • O que é Custódia?
      • O que é Debênture?
      • O que é Nota Comercial?
      • O que é Default?
      • O que é Desembolso?
      • O que é Emissor?
      • O que é Endosso?
      • O que é Investidor Âncora?
      • O que é Investidor Participante?
      • O que é Lastro?
      • O que é Motor de Crédito?
      • O que é Originação?
    • Legislação
      • Licença de SCD pelo Banco Central
      • Securitizadora com Autorização da CVM
      • Certificação CGA Anbima
    • Dúvidas Frequentes
      • Qual o tempo médio para a modelagem completa de uma nova operação de crédito?
      • Qual a diferença entre uma Securitizadora e um FIDC?
      • Como funciona a emissão de uma CCB?
      • Qual a diferença de CDC (Crédito Direto ao Consumidor) e EP (Empréstimo Pessoal)?
      • O que é CORBAN (Correspondente Bancário)?
      • Quais as licenças da GIRO.TECH que são exigidas pelo Banco Central e pela CVM?
      • O que significa PDD?
Fornecido por GitBook
Nesta página
Exportar como PDF
  1. Introdução
  2. Produtos da Giro.Tech
  3. Bancarização (GTBanker)
  4. Webhooks

Sobre

AnteriorWebhooksPróximoCadastro de Webhook

Atualizado há 6 dias

Funcionamento

Webhooks são chamadas que nossa API faz para sua integração após a ocorrência de um evento, como por exemplo o pagamento do desembolso de uma CCB.

É necessário que seu sistema disponibilize um endereço público para chamada de uma requisição HTTPS, via método POST, enviando como autorização um HEADER informado pelo cliente.

Cadastro

Para cadastrar o recebimento dos webhooks, veja as informações no .

Boas práticas

Antes de implementar os webhooks, é crucial avaliar nossas para garantir o correto funcionamento e segurança dos eventos. Seguir essas orientações ajuda a evitar problemas comuns, melhora a eficiência do processamento e assegura a integridade dos dados recebidos.

Headers

O cabeçalho de autorização é um componente crítico na comunicação segura entre o cliente e o servidor. Ele é usado para autenticar a requisição do cliente, garantindo que a mesma seja feita por uma fonte autorizada. Esse cabeçalho será incluído em cada requisição de webhook enviada da API Giro.Tech para o seu servidor.

O cabeçalho de autorização geralmente segue o formato padrão:

Authorization: <Tipo> <Credenciais>
  • Tipo: Indica o método de autenticação utilizado. Para webhooks, comumente é utilizado o "Bearer", que se refere ao uso de um token de acesso.

  • Credenciais: São as informações de autenticação propriamente ditas, como um token JWT ou um token de acesso.

Um exemplo de cabeçalho de autorização com um token de acesso seria:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkNsaWVudGVOYW1lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Outro exemplo, utilizando um header personalizado X-Api-Key

X-Api-Key: dG9rZW4KdG9rZW4KdG9rZW4K

O nome e valor do header que será enviado conforme a sua escolha, então a definição se será um Authorization, Bearer, Basic, ou ApiKey por exemplo, fica a critério da sua implementação de segurança.

Renovação do Tokens

A Giro.Tech não realiza a renovação automática das credenciais cadastradas para o Authorization. Sempre que necessário atualizar alguma informação, novas informações deverão ser enviadas através do .

guia de cadastro
recomendações e boas práticas
cadastro
Central de Atendimento | Giro.TechGiro.Tech
Logo