---
title: "Configurar o Webhook Pix."
method: PUT
path: "/webhook/{chave}"
tags: ["Webhook"]
---

# Configurar o Webhook Pix.

`PUT /webhook/{chave}`

Endpoint para configuração do serviço de notificações acerca de Pix recebidos.
Somente Pix associados a um txid serão notificados.

## Request body

- WebhookSolicitado
  - `webhookUrl` string, uri, required

## Response `200`

Webhook para notificações acerca de Pix recebidos associados a um txid.

## Other responses

- `400` — Requisição com formato inválido.
- `403` — Requisição de participante autenticado que viola alguma regra de autorização.
- `404` — Recurso solicitado não foi encontrado.
- `503` — Serviço não está disponível no momento. Serviço solicitado pode estar em manutenção ou fora da janela de funcionamento.

## Changes

- **2020-12-03** `1ab8ae73a0ae` — 4 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `503`
- **2020-11-06** `f4a2162d6068` — 1 info
  - endpoint added
- **2020-06-29** `5967a4b6f934` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bacen/apis/api-pix/changes/webhook/:chave/put.md)

---

[API](https://skmtc.dev/bacen/apis/api-pix.md) · [All operations](https://skmtc.dev/bacen/apis/api-pix/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bacen/api-pix/revisions/e60160879b89/schema)