Para quem vende · API e webhooks

Integrar SaaS ou app: da venda ao acesso

Seu sistema recebe os avisos de assinatura e cria, mantém ou corta a conta. Use access.granted para liberar, externalId para achar o usuário e plan para saber o plano. O guia da API traz exemplo em Node e Python e um prompt para colar no seu assistente de IA.

Passo a passo

Passe o ID do usuário em external_id no link do checkout.
Crie uma rota que confira X-Korvex-Signature sobre o corpo cru e ignore repetidos por X-Korvex-Event-Id.
Em SUBSCRIPTION_*, ache ou crie a conta e grave access.granted. Não use subscription.status: no teste grátis ele sai INACTIVE.
Mande um link para criar a senha à conta nova. A Korvex não recebe nem guarda essa senha.
Teste com Simular jornada no webhook. As rotas de criar assinatura ainda não existem com sk_test_.

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

Isso ajudou?

Artigos relacionados

SaaS, microsaas ou app: como entregar o acessoA Korvex cobra a assinatura e avisa o seu sistema, que cria, mantém ou corta a conta do cliente. A Korvex não cria login nem guarda senha do seu sistema. O cliente recebe o link de acesso depois de pagar, só enquanto a assinatura estiver em dia.
Webhooks de assinatura: teste grátis, início, renovação, atraso, inativa e canceladaOito 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.
Por que parte do saldo está a liberar ou retidoCom o prazo D+0 (o padrão do Pix), a venda vai para o Disponível segundos depois de o pagamento ser confirmado, logo depois da checagem de segurança, e nem passa por A liberar. A liberar só aparece no Início e em Saldo e saques quando há venda com prazo de D+1 ou mais (cartão, boleto ou Pix com prazo maior), com a data da próxima liberação. Se houver reserva, uma parte fica retida por mais alguns dias. Venda em análise ou com contestação aberta fica travada até a decisão. O Extrato mostra linha a linha.
Primeiros passos: da conta criada à primeira vendaA conta passa por etapas, na ordem em que a equipe confere: confirmar o e-mail, preencher os dados, enviar os documentos, cadastrar a chave Pix de saque e a conta bancária e, por último, tocar em Enviar para análise. Tudo fica em Sua conta › Verificação da conta, numa página só. O cadastro só chega à equipe depois do envio: com tudo preenchido e ainda não enviado, o guia de ativação mostra "Tudo pronto: falta enviar para análise". Até a aprovação, vender, sacar e integrar ficam limitados.