Ciclo de vida
Cada transição gera um webhook de assinatura.- Criação: comprador assina pelo link de pagamento (ou sessão de checkout via API). O token de cartão recorrente é criado pelo provedor no primeiro pagamento.
- Cobranças: cada ciclo gera uma fatura com o valor da oferta no momento da assinatura. PIX recorrente usa PIX Automático.
- Cancelamento: pelo próprio comprador no portal do cliente ou por você via API.
Consultar e cancelar
accessUntil, quando a assinatura passa a EXPIRED.
200comstatus: CANCELED: cancelada.202comstatus: CANCELLATION_REQUESTED: a Korbit está encerrando a autorização recorrente no meio de pagamento. A confirmação chega pelo webhooksubscription.canceled.v1.
refund.* e dispute.*.
Webhooks de assinatura
Assine os eventossubscription.* para manter seu sistema em dia sem polling: liberar acesso na ativação, registrar renovações, avisar o cliente quando uma cobrança falhar e remover o acesso quando a assinatura expirar.
Payload, motivos e exemplos estão no Catálogo de eventos.
Faturas
GET /v1/subscriptions/{id}/invoices retorna as faturas por ciclo, com valor, data e estado da cobrança correspondente — a base da sua conciliação de recorrência.