Para quem vende · API e webhooks

API: assinaturas por Pix e cartão

As rotas de assinatura criam a recorrência (tipo, intervalo e primeira cobrança em N dias). Cada ciclo é uma transação com o objeto subscription no webhook; o webhook é a fonte da verdade para liberar e cortar o acesso.

Passo a passo

Crie com POST /gateway/pix/subscription (ou a de cartão) com product e subscription.
Libere o acesso no webhook de pagamento, não na resposta da criação.
Consulte com GET /gateway/subscriptions e acompanhe atraso e cancelamento pelos eventos.

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

Isso ajudou?

Artigos relacionados

Webhooks de assinatura: teste grátis, início, renovação, atraso, inativa e canceladaSete 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.
Renovação antecipada da assinatura com descontoNa assinatura, gere um link para o assinante pagar vários ciclos de uma vez (ex.: 3 meses) com desconto opcional. Pago o Pix, os próximos vencimentos são empurrados e as cobranças desses ciclos não saem.
API: a Korvex não manda e-mail ao seu compradorNas cobranças criadas pela API (Pix, cartão, boleto e assinaturas, inclusive as renovações), nenhum e-mail sai para o comprador: nem compra aprovada, nem Pix gerado, lembretes, reembolso, acesso à área de membros, aviso de acesso novo ou cobrança da assinatura: nenhuma confirmação de entrega. A comunicação é do seu sistema, pelos webhooks. O checkout hospedado criado pela API continua com os e-mails, porque o comprador paga na página da Korvex.
Como criar uma oferta de assinaturaProduto do tipo Assinatura tem ofertas recorrentes: valor, intervalo (semanas, meses ou anos), primeira cobrança em N dias (teste grátis) e valor diferente na primeira cobrança, se quiser.