Members
AjudaPolíticasEntrar← Início
← Central de Ajuda

Webhooks e Utmify

Em Integrações você conecta seus sistemas ao Members. A cada mudança de status de uma venda enviamos um aviso, com nova tentativa automática se o seu sistema estiver fora do ar.

Webhooks

  1. Clique em Adicionar webhook e informe um endereço público que comece com https://.
  2. Escolha os eventos e, se quiser, filtre por produto.
  3. Guarde o segredo exibido logo depois de salvar. Ele não aparece de novo.
  4. Use Enviar teste para receber um exemplo marcado com "test": true.

Eventos

  • sale.pending: Pix ou boleto gerado, aguardando pagamento.
  • sale.approved: pagamento aprovado e acesso liberado.
  • sale.refused: cartão recusado ou Pix vencido.
  • sale.refunded: venda reembolsada.
  • sale.chargeback: o comprador contestou a cobrança no cartão.
  • checkout.abandoned: o comprador começou e não concluiu a compra (mesmo momento do e-mail de recuperação).
  • subscription.renewed: um novo ciclo da assinatura foi pago.
  • subscription.canceled: a assinatura foi cancelada.

Como chega

Um POST com corpo JSON e os cabeçalhos X-Members-Event, X-Members-Delivery e X-Members-Signature. Responda com qualquer código 2xx em até 10 segundos. Outras respostas geram novas tentativas com espera crescente (até 8 tentativas).

O mesmo evento de um mesmo pedido é enviado uma única vez por webhook; numa nova tentativa o corpo é idêntico. Use o campo id para ignorar repetições. Valores em centavos.

{
  "id": "evt_…",
  "type": "sale.approved",
  "api_version": "2026-10-31",
  "created_at": "2026-10-31T15:04:05.000Z",
  "test": false,
  "data": {
    "order": { "id": "…", "status": "confirmed", "payment_id": "pay_…",
               "created_at": "…", "paid_at": "…", "refunded_at": null, "installments": 1 },
    "product": { "id": "…", "name": "Meu curso" },
    "offer": { "id": "…", "name": "Oferta principal" },
    "items": [{ "product_id": "…", "offer_id": "…", "name": "Meu curso", "role": "main", "price_cents": 9700 }],
    "customer": { "name": "…", "email": "…", "phone": null, "document": null },
    "amounts": { "currency": "BRL", "gross_cents": 9700, "discount_cents": 0,
                 "gateway_fee_cents": 199, "producer_cents": 8700 },
    "payment": { "method": "pix" },
    "subscription": null,
    "tracking": { "utm_source": "instagram", "utm_medium": null, "utm_campaign": "lancamento",
                  "utm_content": null, "utm_term": null, "src": null, "sck": null,
                  "gclid": null, "fbclid": null }
  }
}

Validar a assinatura

X-Members-Signature tem o formato t=<segundos>,v1=<hex>. O valor v1 é o HMAC-SHA256 do texto t + "." + corpo cru usando o seu segredo. Recuse avisos com mais de 5 minutos.

import { createHmac, timingSafeEqual } from "node:crypto";

// header = "t=1730386800,v1=<hex>"
function valido(segredo, corpoCru, header) {
  const partes = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(partes.t)) > 300) return false;
  const esperado = createHmac("sha256", segredo).update(`${partes.t}.${corpoCru}`).digest("hex");
  return timingSafeEqual(Buffer.from(esperado, "hex"), Buffer.from(partes.v1, "hex"));
}

Utmify

  1. Na Utmify, abra Integrações → Webhooks → Credenciais de API e copie o token.
  2. No Members, cole o token em Integrações → Utmify.
  3. Clique em Enviar teste: a Utmify valida o pedido de exemplo sem salvá-lo.

Enviamos cada pedido com os status waiting_payment, paid, refused, refunded e chargedback, junto com produtos, comprador, sua comissão e os parâmetros utm_*, src e sck do link de checkout.

Acompanhar

Em Integrações, a lista Últimas entregas mostra status, código HTTP e tentativas de cada envio.

Dúvidas: [email protected].

Members

Seu conhecimento, seus produtos. Um lugar para criar, vender e aprender.

Nosso compromisso →

Navegação

  • Início
  • Solução
  • Marketplace
  • Faça parte
  • Entrar

Recursos

  • Conheça o Members
  • Blog do Members
  • Central de Ajuda
  • Como criar um produto
  • Perguntas frequentes

Institucional

  • Privacidade
  • Termos de uso
  • Política de taxas
  • Política de conteúdo
  • LGPD

Redes sociais

  • Instagram
  • YouTube
  • LinkedIn

Precisa de ajuda? [email protected]

Visite a Central de Ajuda →

© 2026 Members. Todos os direitos reservados.

Desenvolvido por AG LABS