Trigger & webhooks

O Selectwin Trigger inicia workflows quando eventos acontecem na sua conta — sem polling, sem infraestrutura própria de webhook.

Como usar

1. Adicione o nó Selectwin Trigger como primeiro nó do workflow.
2. Selecione a credencial e os eventos que devem disparar o fluxo — ex.: transaction.approved para pagamento confirmado. São 72 eventos disponíveis, o catálogo completo da Selectwin (transações, assinaturas, clientes, recebíveis, saques, checkout…). Veja o catálogo de eventos.
3. Ative o workflow. O nó registra o webhook na Selectwin automaticamente (POST /v1/webhooks) apontando para a URL do seu n8n, e guarda o secret de assinatura. Ao desativar o workflow, o webhook é removido.

Não é preciso criar nada no painel da Selectwin — o ciclo de vida do webhook é gerenciado pelo nó.

Segurança: assinatura verificada

Toda entrega é verificada antes de disparar o workflow, sobre os bytes crus recebidos:

• Preferência pelo header x-selectwin-signature-v1 (t=<unix>,v1=<hmac>), que é anti-replay — entregas com timestamp fora da tolerância (padrão 300s, ajustável em Options → Tolerance) são rejeitadas.
• Fallback para o header legado x-selectwin-signature (sha256=<hmac>) quando o v1 não está presente.
• Assinatura inválida → resposta 401 e o workflow não dispara.

A comparação é constant-time e o segredo nunca aparece nos dados do workflow. Detalhes do contrato em Webhooks.

O que chega no workflow

Cada disparo entrega o envelope completo do evento; o recurso vem em payload.object:

{
  "id": "evt_…",
  "type": "transaction.approved",
  "payload": {
    "object": {
      "id": "tra_…",
      "status": "approved",
      "externalReference": "pedido-1042"
    }
  },
  "createdAt": "2026-07-03T12:00:00.000Z"
}

Use {{ $json.payload.object.externalReference }} para casar o evento com o pedido no seu sistema.

Receita: PIX confirmado → avisar o cliente

1. Selectwin Trigger — evento transaction.approved.
2. IF — {{ $json.payload.object.method }} igual a pix (opcional).
3. E-mail / WhatsApp / Slack — confirme o pagamento usando os dados de payload.object.