Webhooks

Sobre os webhooks de vendedores

Webhooks de Vendedores

Os webhooks permitem cadastrar URLs para receber notificações relacionadas às operações realizadas pelo vendedor.

Cada webhook fica associado a um vendedor e pode ser consultado, atualizado ou removido por meio das rotas disponíveis nesta seção.

Operações disponíveis

OperaçãoMétodoDescrição
Consultar um WebhookGETRetorna os dados de um webhook específico.
Consultar Webhooks VendedoresGETRetorna os webhooks cadastrados para os vendedores.
Criar Webhook VendedorPOSTCadastra um novo webhook para um vendedor.
Atualizar Webhook VendedorPUTAtualiza os dados de um webhook existente.
Deletar Webhook VendedorDELETERemove um webhook cadastrado.

Fluxo recomendado

  1. Cadastre o vendedor.
  2. Crie um webhook informando a URL que receberá as notificações.
  3. Consulte o webhook para verificar os dados cadastrados.
  4. Atualize a configuração quando houver alteração na URL.
  5. Remova o webhook quando ele não for mais utilizado.

Configuração do webhook

Antes de cadastrar um webhook, disponibilize uma URL capaz de receber e processar as notificações enviadas pela plataforma.

A URL deve estar acessível para que a Cyclopay consiga realizar o envio das notificações.

Quando necessário, utilize o identificador do vendedor retornado pelas rotas de criação ou consulta de vendedores.