#Webhooks

O Clickmax tem dois tipos de webhook: entrada (in), que recebe eventos de uma plataforma externa, e saída (out), que envia um evento do Clickmax para uma URL externa quando um gatilho acontece.

Papel exigido: membro autenticado do workspace. A gestão de webhooks fica na área de Integrações.

#Direção

#Plataformas de entrada

Valores aceitos ao criar um webhook de entrada.

#Plataformas de saída

Destinos aceitos ao criar um webhook de saída.

#Gatilhos

Eventos que disparam um webhook de saída (campo trigger).

#Cartão recusado x transação falhou

REFUSED_CARD dispara uma vez por tentativa de pagamento em que o cartão foi enviado à cobrança e recusado. Uma segunda tentativa do comprador com o mesmo cartão, alguns minutos depois, é uma nova recusa e dispara de novo.

Compra que nem chega à cobrança — cartão obrigatório não informado, produto sem estoque, conta do vendedor pendente, endereço de entrega faltando — não é recusa de cartão: dispara só TRANSACTION_FAILED. Pix e boleto que falham também usam apenas TRANSACTION_FAILED.

#Status dos registros

Cada entrega gera um registro com um destes status.

#Relacionados

• Integrações e plataformas suportadas
• Eventos e rastreamento
• Referência da API
• Papéis e permissões

#Se não funcionou

• A plataforma recebe 401 no envio de entrada: o webhook está inativo, foi excluído, ou o token/assinatura não confere — veja Códigos de erro.
• Webhook de saída não chega ao destino: confira o status do registro e a resposta do endpoint em Códigos de erro.
• Dúvidas gerais sobre integrações: consulte as Perguntas frequentes.