> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/webhooks/cadastro-de-webhook.md).

# Cadastro de Webhook

### Cadastro de Webhook

Para receber quaisquer dos eventos disponibilizados, é necessário requisitar o cadastro de endereço para o recebimento dos eventos.\
Atualmente, esse cadastro é feito de maneira manual e deve ser solicitado através do link:

➡️ [**CLIQUE AQUI PARA ACESSAR O FORMULÁRIO.**](https://noteforms.com/forms/tabela-cadastro-webhooks-pc8nua)

⚠️ Como esse cadastro é efetuado manualmente, pode levar até 2 dias úteis para ser processado. Esteja ciente de que o fluxo pode não estar disponível imediatamente após a requisição.

Após a requisição do cadastro, a equipe da Giro avaliará o registro e poderá entrar em contato para validar as informações necessárias.

#### Ambiente

Certifique-se de informar corretamente o ambiente correspondente para o cadastro desejado.\
Os webhooks estão disponíveis tanto para o ambiente de homologação quanto para produção.

Exemplos:

* Homologação: `https://homologacao.suaapi.com/webhooks`
* Produção: `https://api.suaapi.com/webhooks`

#### Endereço webhook

É necessário cadastrar endereço público para chamada de uma requisição **HTTPS**, via método **POST**, enviando como autorização um **HEADER**.

O cadastro do endereço possui um limite de 511 caracteres. Isso inclui tanto a URL quanto parâmetros adicionais que o seu sistema necessite.

#### Tipo de evento

Devem ser selecionados os eventos que sua integração irá necessitar.

O cadastro dos endereços será feito por tipo de evento, podendo ficar a seu critério definir endereços distintos para cada evento ou o mesmo endereço para todos os eventos.

Não é necessário realizar o cadastro para todos os eventos disponíveis.

⚠️ Alguns eventos, no entanto, só poderão ser cadastrados de maneira conjunta, como por exemplo `FALHA_DESEMBOLSO` e `REVISAO_DESEMBOLSO` ⚠️

Certifique-se de verificar esses requisitos antes de completar seu cadastro.

<figure><img src="https://978140111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF6l1W0qI0y7eF7f0QRDC%2Fuploads%2Fgit-blob-f5d2064d02c970341ca52b2c083eb1f585bc436a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
