Para quem vende · API e webhooks

Webhooks do Parcelado no Pix: parcela paga, atraso, plano cancelado e quitado

Marque INSTALLMENT_PAID, INSTALLMENT_LATE, INSTALLMENT_PLAN_CANCELED e INSTALLMENT_PLAN_PAID_OFF (pacote Parcelado no Pix) no webhook do painel ou em events do POST /gateway/webhooks. Só quem marca recebe. O corpo traz installmentPlan (situação, valores, pago, a pagar, próximo vencimento) e installment (entrada = número 0, parcela n de N, transactionId e, no atraso, o link para pagar). As parcelas não chegam como SUBSCRIPTION_* e o subscription das transações delas vem null.

Passo a passo

Marque os eventos do pacote Parcelado no Pix no webhook.
Use installmentPlan.status (ON_TIME, LATE, PAID_OFF, CANCELED) e accessSuspended para a sua régua.
Ligue cada parcela à venda pelo installment.transactionId.
Deduplique pelo X-Korvex-Event-Id e trate campo desconhecido como opcional.

Isso ajudou?

Artigos relacionados

Parcelado no Pix: entrada e parcelas mensais no Pix, com a chave por ofertaNa tela do produto, seção Parcelado no Pix, ligue a chave da oferta (vem desligada) e escolha a entrada (valor ou %), de 2 a 12 parcelas mensais, um acréscimo opcional por parcela (até 5 %, fica com você) e quantos dias de atraso até suspender o acesso. O checkout passa a mostrar "Entrada R$ X + N× R$ Y no Pix" ao lado do à vista, e o comprador marca o aceite (guardado com data, IP e versão). Cada parcela é uma venda no Pix, com a taxa de sempre e as comissões; o Pix de cada uma vai por e-mail e fica na área do cliente. Atrasou além do prazo: o acesso fica suspenso até pagar (o plano não é cancelado sozinho). Pagou a última: quitado, com o acesso. Se o comprador parar de pagar, a Korvex não cobre a diferença. Desligar a chave tira a opção dos compradores novos; quem já parcelou continua. Em Vendas › Parcelado no Pix você vê quem está em dia, atrasado, quitado ou cancelado, o pago e o que falta, cancela um plano e exporta o CSV.
API: cartão parcelado — o amount já inclui os jurosNo POST /gateway/card/receive parcelado, mande em amount o total que o comprador vai pagar, com os juros. A plataforma calcula a base (Tabela Price inversa), cobra a sua taxa sobre ela e o comprador paga exatamente o amount. À vista, amount é o preço.
Webhooks: eventos de transação, saque, disputa e sessãoOs eventos cobrem transação (criada, paga, cancelada, reembolsada, contestada, Pix expirado), saque (criado, concluído, falhou), disputa (MED e chargeback) e sessão do checkout (inclusive carrinho abandonado) e, se você assinar, um ORDER_BUMP_PAID por order bump pago. Todo aviso traz o token e o identifier.
Parcelamento: parcelas, sem juros e quanto você recebeEm Pagamento › Cartão e parcelas (no menu do produto) você escolhe até quantas parcelas, qual já vem marcada, quem paga os juros em cada oferta e como as parcelas aparecem (lista para escolher ou todas à vista). Ao lado, a prévia mostra, com a mesma conta do checkout, quanto o comprador paga e quanto você recebe em cada parcela — e muda na hora, antes de salvar. Produto sem cartão mostra o aviso com o botão Ligar o cartão.