Produto · Webhooks
Sua operação avisada na hora
Venda aprovada, estorno, assinatura em atraso, saque confirmado: o seu servidor fica sabendo por um aviso assinado. Se ele cair, a Selectwin tenta de novo sozinha. Se precisar, você reenvia com um clique.
- Mais de 50 eventos
- Assinatura em toda entrega
- Tenta de novo sozinha
O que faz
Conheça os Webhooks
Webhooks é como a Selectwin conta ao seu sistema o que acabou de acontecer na sua conta. Você aponta uma URL, escolhe os eventos e pronto: o ERP fatura, a área de membros libera o acesso e a automação dispara, sem ninguém perguntar à API se algo mudou. Cada entrega fica à vista na Workbench, e tudo vem incluído em toda conta.
Mais de 50 eventos
Venda aprovada, recusada, estornada, em disputa e em chargeback, assinatura, recebível, saque, cliente, cartão, situação da conta, carrinho abandonado e compra concluída no checkout. Cada endpoint ouve só o que interessa a ele.
Assinatura em toda entrega
Cada aviso chega assinado com o segredo do seu endpoint. Confira a assinatura, e quem descobrir a sua URL não consegue forjar uma "venda aprovada".
Tenta de novo sozinha
Servidor fora do ar? A Selectwin tenta de novo com intervalos crescentes: até 12 tentativas por entrega, ao longo de cerca de 3 dias. Queda curta se resolve sem ninguém mexer em nada.
O objeto da API, com a origem da venda
O aviso traz a venda no mesmo formato da leitura da API, com a campanha de origem e os cookies de rastreio prontos para a API de conversões das suas plataformas de anúncio.
Um id por evento
O mesmo id em toda nova tentativa e em todo reenvio. Processe cada id uma vez, e a entrega repetida nunca vira pedido em dobro.
E mais
Também entra no pacote
- Assinatura dupla na troca de segredoPor 24 horas, cada entrega leva duas assinaturas, em cabeçalhos separados: a do segredo novo e a do antigo. O seu servidor confere a antiga enquanto você atualiza.
- Proteção automáticaEndpoint que só falha é desligado sozinho, e a Workbench diz por quê.
- Teste e reenvio também pela APIMande um evento de teste pelo painel, pela API ou pela linha de comando, e reenvie um evento ou uma entrega pelo painel ou pela API, sem abrir chamado.
- Marketplace num endpoint sóA plataforma recebe os eventos de todos os vendedores, cada um marcado com a subconta de origem.
Como funciona
Do endpoint ao primeiro aviso, em 4 passos
- 1
Passo 1
Cadastre a URL
No painel ou pela API, com endereço https. Escolha os eventos, ou todos, inclusive os que vierem depois.
- 2
Passo 2
Guarde o segredo
Ele aparece uma vez só, e é com ele que cada entrega chega assinada.
- 3
Passo 3
Valide e processe
Confira a assinatura (os SDKs fazem isso em uma linha), responda 2xx em até 30 segundos e descarte repetição pelo id do evento.
- 4
Passo 4
Acompanhe
A Workbench mostra o que entrou, o que falhou e o que o seu servidor respondeu. Corrigiu? Reenvie com um clique.
Na prática
Onde os Webhooks entram na venda
Cada etapa é um produto da mesma stack: a venda passa de uma para a outra dentro da Selectwin. Escolha um cenário e acompanhe o caminho.
PagamentoCheckoutPix · R$ 146,43
O cliente paga com Pix no seu checkout. O servidor calcula, congela e cobra o total.
AntifraudeVaelaprovada
O Vael avalia a compra antes da cobrança e deixa passar.
aprovarevisabloqueia
RoteamentoRoteoPix cobrado
O Roteo orquestra a cobrança do Pix: leva ao processamento e confere o resultado na origem.
MensagensSmartOps
A mensagem certa em cada momento da venda: e-mail, WhatsApp e SMS em nome da sua empresa, com o link para pagar.
Aprovaçãoconfirmado
Pix confirmado na hora e cobrado uma única vez.
SplitRepart3 destinos · 100%
Você, o coprodutor e o sócio recebem cada um a sua parte, cada um no seu prazo.
Você 70%Coprodutor 20%Sócio 10%
SaldoFinancerecebível
O valor vira um recebível com data, e o saque automático leva.
Webhooksreceivable.scheduled
Mais de 50 eventos assinados avisam o seu ERP, o seu CRM e as suas automações.
O problema
O que trava a sua integração hoje
- Consultar a API de minuto em minuto para saber se a venda aprovou: caro, lento e ainda assim atrasado.
- O servidor fica fora do ar por dez minutos, e o pedido daquela hora nunca é liberado.
- Não ter como provar que a chamada recebida veio mesmo da Selectwin, e não de alguém que descobriu a sua URL.
- Trocar o segredo de assinatura abre uma janela de entregas recusadas até o seu servidor ser atualizado.
Para quem é
Quem mais aproveita
- Quem integra ERP, CRM ou planilhaA venda, o estorno e o recebível chegam sozinhos ao seu sistema, sem consulta em loop.
- Quem vende curso, acesso ou assinaturaLibera o acesso no aprovado e corta no atraso ou no cancelamento, no momento do aviso.
- Plataformas de marketplaceUm endpoint para os eventos de todos os vendedores, inclusive a aprovação do cadastro de cada um.
- Times de automação e de tráfego pagoO n8n dispara sem uma linha de código, e a campanha de origem chega dentro do aviso.
Mais com a Selectwin
Mais que Webhooks: uma stack conectada
Pagamentos, conta, proteção e crescimento num lugar só.
Integrações
Conecte com o que você já usa
- n8n
- Meta CAPI
- GA4
- Google Tag Manager
- TikTok
- Snap
Incluído em toda conta Selectwin, sem custo extra.
Eventos, histórico, reenvio, teste e a Workbench fazem parte da plataforma. Não são módulo pago à parte.
Perguntas rápidas
Ainda com dúvida?
Fale com o seu gerente de conta pelo WhatsApp ou e-mail, de segunda a sexta, das 8h às 18h.
Central de ajudaCada entrega vem assinada com o segredo do seu endpoint, que só você recebe e mais ninguém vê depois. Os SDKs conferem em uma linha. Quer ir além? Confira também a assinatura com carimbo de tempo e recuse entregas antigas reaproveitadas.
Os eventos ficam no histórico. A Selectwin tenta de novo sozinha, até 12 vezes por entrega, ao longo de cerca de 3 dias. Se o endpoint só falha, a proteção automática o desliga e o painel mostra o motivo. Depois de corrigir, você reativa e reenvia cada evento com um clique.
Pode. Por isso cada evento tem um id que não muda, nem na nova tentativa nem no reenvio. Processe cada id uma vez e pronto.
Não precisa cair. Por 24 horas, cada entrega leva duas assinaturas, a do segredo novo e a do antigo, em cabeçalhos separados. Confira a antiga enquanto atualiza o seu servidor, e nenhuma entrega é recusada na troca.
Não. O sandbox tem endpoints próprios: venda de teste só chega ao endpoint de teste. Para conferir a ligação sem venda nenhuma, use o "Enviar teste" da Workbench.
Sim. O gatilho da Selectwin para o n8n cria o endpoint, guarda o segredo e valida a assinatura sozinho. Basta um n8n próprio, com endereço https público.