# Configurando Webhooks

#### O que são Webhooks?

Webhooks são **notificações automáticas** enviadas pela Barte para o seu sistema sempre que ocorre **uma alteração de status em uma transação ou evento importante**.

Em vez de consultar a API repetidamente para saber se algo mudou, a Barte envia uma requisição HTTP para a URL configurada, informando o evento ocorrido e seus dados.

***

#### Quando a Barte dispara webhooks?

Atualmente, a Barte dispara webhooks para os seguintes tipos de eventos:

* **Pedidos (Orders) e Assinaturas (Subscriptions)**\
  Ex: pagamento confirmado, pendente, cancelado ou expirado.
* **Pedidos Físicos (Maquininhas)**\
  Ex: atualização do status da transação realizada na maquininha.
* **Disputas e Chargebacks**\
  Ex: abertura, atualização ou encerramento de uma disputa.

Os webhooks são enviados **sempre que uma transação sofre alteração de status**, permitindo que seu sistema reaja automaticamente a cada mudança.

***

#### Por que usar webhooks?

* Atualizar pedidos automaticamente no seu sistema
* Confirmar pagamentos de PIX e boleto
* Liberar produtos ou serviços após pagamento
* Tratar cancelamentos, estornos, disputas e chargebacks

#### Fluxo Visual

<figure><img src="https://3327708375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FclefZmvRP6lLsZodSCrq%2Fuploads%2FLxldTqphBhLBncCnF5y5%2Fimage.png?alt=media&#x26;token=a2918c03-1242-43ae-8aff-2740461906af" alt=""><figcaption></figcaption></figure>

#### Como cadastrar um Webhook

* Na tela apresentada, clique no campo ao lado direito superior da tela "Novo Webhook", abrirá um campo para inserir a nova chave webhook, depois de preencher, clique em "Salvar"
* Abaixo o cadastro do webhook estará inserido, e as opções de ativar ou desativar a API cadastrada ou excluir no ícone de lixo.&#x20;

{% embed url="<https://drive.google.com/file/d/1gOvgmerdnxqN56jUabhg_pJn4uAi5b53/view>" %}
Lembrando que:\
Caso o passo a passo apresente erro ou não consiga efetuar a ação, entre em contato com o time de Suporte Barte.
{% endembed %}