PATCH/webhooks/{id}

Atualizar

Atualiza um evento de webhook e/ou ouvinte de URL. Uma vez atualizado, todos os eventos que forem acionados replicarão a lógica atualizada.

Parameters

Path Parameters

Name	Type	Description
`id`required	string (uuid)	identificador primário do webhook

Request Body

required

All fields are optional. Send only the ones you want to change. event: One of the supported event types. url: An https url that will receive the POST of the event. headers: optional key-value pairs to send with the POST of the event. Send null to clear them. enabled: re-enable a webhook that was previously disabled (after repeated delivery failures or via internal cleanup).

object

Atualização parcial de um webhook. Todos os campos são opcionais.

urlstring

New https url that will receive the POST of the event. Same rules as on creation.

eventobject

Novo evento que o webhook deve escutar

All of:

part 1string

Evento ao qual o webhook se inscreve. Use `all` para receber todos os eventos para o cliente. Os eventos são agrupados por tópico: **item/** – Ciclo de vida de um item (uma conexão com uma instituição financeira). - `item/created`: um novo item foi criado. - `item/updated`: o item terminou uma execução com novos dados. - `item/error`: a execução terminou com um erro (veja o campo `error` do payload). - `item/deleted`: o item foi deletado. - `item/waiting_user_input`: o item precisa de credenciais adicionais/MFA do usuário final. - `item/waiting_user_action`: o item precisa que o usuário final realize uma ação do lado da instituição. - `item/login_succeeded`: as credenciais foram aceitas pela instituição (os dados ainda podem estar sincronizando). **connector/** – Eventos em nível de conector. - `connector/status_updated`: o status de saúde de um conector mudou (ONLINE/OFFLINE/UNSTABLE). **transactions/** – Ciclo de vida de transações de conta. - `transactions/created` / `transactions/updated` / `transactions/deleted`: uma transação foi inserida, modificada ou removida durante uma execução de item. **payment_intent/** – Fluxo de Iniciação de Pagamento (PIX único). - `payment_intent/created`: uma intenção de pagamento foi criada. - `payment_intent/completed`: o pagamento foi confirmado pela instituição. - `payment_intent/waiting_payer_authorization`: o pagador ainda precisa autorizar o pagamento. - `payment_intent/error`: o pagamento foi rejeitado ou falhou. **payment_request/** – Estado agregado de solicitação de pagamento. - `payment_request/updated`: o status geral de uma solicitação de pagamento mudou. **scheduled_payment/** – Pagamentos agendados (recorrentes ou futuros). - `scheduled_payment/created` / `completed` / `error` / `canceled`: ciclo de vida de um único pagamento agendado. - `scheduled_payment/all_created` / `scheduled_payment/all_completed`: emitido uma vez quando cada pagamento agendado em uma série atinge o mesmo estado terminal. **boleto/** – Atualizações de status do boleto. - `boleto/updated`: os dados do boleto foram atualizados (por exemplo, pago, expirado, valor alterado). **automatic_pix_payment/** – Pagamentos individuais recorrentes de PIX (PIX Automático). - `automatic_pix_payment/created`: um novo pagamento recorrente foi agendado. - `automatic_pix_payment/completed`: o pagamento recorrente foi confirmado. - `automatic_pix_payment/error`: o pagamento recorrente falhou. - `automatic_pix_payment/canceled`: o pagamento recorrente foi cancelado (pelo usuário, expiração ou consentimento revogado). **smart_transfer_preauthorization/** – Pré-autorização de Transferência Inteligente (configuração de consentimento). - `smart_transfer_preauthorization/completed`: a pré-autorização foi aceita. - `smart_transfer_preauthorization/error`: a pré-autorização falhou. **smart_transfer_payment/** – Pagamentos individuais de Transferência Inteligente executados sob uma pré-autorização ativa. - `smart_transfer_payment/completed`: a transferência foi bem-sucedida. - `smart_transfer_payment/error`: a transferência falhou.

allitem/createditem/updateditem/erroritem/deleteditem/waiting_user_inputitem/waiting_user_actionitem/login_succeededconnector/status_updatedtransactions/createdtransactions/updatedtransactions/deletedpayment_intent/createdpayment_intent/completedpayment_intent/waiting_payer_authorizationpayment_intent/errorpayment_request/updatedscheduled_payment/createdscheduled_payment/completedscheduled_payment/errorscheduled_payment/canceledscheduled_payment/all_completedscheduled_payment/all_createdboleto/updatedautomatic_pix_payment/createdautomatic_pix_payment/completedautomatic_pix_payment/errorautomatic_pix_payment/canceledsmart_transfer_preauthorization/completedsmart_transfer_preauthorization/errorsmart_transfer_payment/completedsmart_transfer_payment/errorpix_biometric_enrollment/authorizedpix_biometric_enrollment/revokedpix_biometric_enrollment/error

headersobject | null

Cabeçalhos HTTP a serem incluídos nas notificações de webhook. Envie null para limpar os cabeçalhos existentes.

enabledboolean

Reative um webhook que foi desativado anteriormente. Quando definido como verdadeiro, limpa o timestamp disabledAt.

Example

json

{
  "url": "string",
  "event": null,
  "headers": null,
  "enabled": true
}

Responses

200Atualize o webhook que foi enviado

object

idrequiredstring

Identificador UUID para a entidade

urlrequiredstring

Url para ser notificado sobre alterações de item

eventrequiredstring

disabledAtstring (date-time) | null

Data em que o webhook foi desativado

createdAtstring (date-time)

Data em que foi criado

updatedAtstring (date-time)

Data da última atualização

headersrequiredobject

Cabeçalhos personalizados enviados com cada entrega de webhook. Sempre presentes; um objeto vazio quando nenhum está configurado.

<key>string

Example response

json

{
  "id": "string",
  "url": "string",
  "event": "all",
  "disabledAt": "2024-01-01T00:00:00Z",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z",
  "headers": {
    "<key>": "string"
  }
}

curl -X PATCH \
  'https://api.pluggy.ai/webhooks/{id}' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -d '{ "url": "string", "event": null, "headers": null, "enabled": true }'

Resposta de exemplo

{
  "id": "string",
  "url": "string",
  "event": "all",
  "disabledAt": "2024-01-01T00:00:00Z",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z",
  "headers": {
    "<key>": "string"
  }
}