Para quem vende · API e webhooks

Webhooks de assinatura: teste grátis, início, renovação, atraso, inativa e cancelada

Sete eventos acompanham a assinatura: SUBSCRIPTION_TRIAL_STARTED, SUBSCRIPTION_STARTED (1º pagamento), SUBSCRIPTION_RENEWAL_PENDING (link de renovação enviado, uma vez por ciclo, com o renewalUrl), SUBSCRIPTION_RENEWED, SUBSCRIPTION_LATE, SUBSCRIPTION_EXPIRED (acesso suspenso) e SUBSCRIPTION_CANCELED. Todos trazem subscription.cycle, os dados do cliente e o reason. Só recebe quem marca os eventos no webhook; o callbackUrl da venda recebe só o atraso e o cancelamento.

Passo a passo

1. Em Integrações › Conexão direta, crie ou edite o webhook e marque os eventos do grupo Assinaturas (pela API, use events no POST /gateway/webhooks).
2. Libere o acesso no SUBSCRIPTION_STARTED e no SUBSCRIPTION_RENEWED; corte no SUBSCRIPTION_EXPIRED e no SUBSCRIPTION_CANCELED.
3. No SUBSCRIPTION_RENEWAL_PENDING, mande o renewalUrl ao assinante pelo seu canal (WhatsApp, SMS); ele é o mesmo link do e-mail da Korvex.
4. Leia o reason para saber o motivo (ex.: NON_PAYMENT, DISPUTE, BUYER) e deduplique pelo X-Korvex-Event-Id.

Já tem conta? Este passo a passo fica em Abrir Webhooks, no painel.