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
- Clique em Adicionar webhook e informe um endereço público que comece com
https://. - Escolha os eventos e, se quiser, filtre por produto.
- Guarde o segredo exibido logo depois de salvar. Ele não aparece de novo.
- 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
- Na Utmify, abra Integrações → Webhooks → Credenciais de API e copie o token.
- No Members, cole o token em Integrações → Utmify.
- 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].