Notificação de mudança de status da parcela

post

https://api-bnpl-wl.sandbox.open-co.tech/webhooks/installment-status

Direção: Inbound (QI Tech / infraestrutura de pagamento → BNPL WL). Parceiros não chamam este endpoint diretamente.

Endpoint webhook chamado pela QI Tech quando o status de uma parcela muda. Esta notificação é usada para manter o sistema BNPL sincronizado com a instituição financeira.

Transições de status comuns:

PENDING -> PAID: Pagamento normal dentro do prazo
PENDING -> OVERDUE_GRACE: Pagamento não realizado após o vencimento (sem multas ainda, limite BNPL zerado)
OVERDUE_GRACE -> OVERDUE_PENALTY: Período de carência expirado, multas e juros agora se aplicam
PENDING -> PAID_EARLY: Pagamento antes do vencimento
OVERDUE_PENALTY -> PAID_OVERDUE: Pagamento em atraso com multa/juros
OVERDUE_PENALTY -> PAID_PARTIAL_OVERDUE: Pagamento parcial em atraso
OVERDUE_GRACE -> PAID: Pagamento recebido durante o período de carência (sem multas)
PENDING -> WAITING_PAYMENT: Pagamento iniciado, mas não confirmado

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Payload de webhook enviado pela QI Tech quando o status de uma parcela muda. Usado para manter o sistema BNPL sincronizado com a instituição financeira.

person_id

uuid

required

Identificador da pessoa associada a esta parcela

webhook_type

string

enum

required

Tipo de evento webhook

Show Details

installment.status_change

Disparado quando o status de pagamento de uma parcela muda

Allowed:

installment_id

string

required

Identificador da parcela

previous_status

string

enum

required

Status anterior da parcela antes da mudança

Show Details

PENDING	Aguardando pagamento, ainda não vencida
PAID	Paga dentro do prazo e integralmente
OVERDUE_GRACE	Vencida sem pagamento; limite BNPL normal mantido; sem multas ou juros aplicados ainda
OVERDUE_PENALTY	Vencida além do período de carência; multas e juros acumulam diariamente
PAID_EARLY	Paga antes do vencimento (pode qualificar desconto)
PAID_PARTIAL	Parcialmente paga dentro do prazo
PAID_OVERDUE	Paga integralmente após o vencimento (inclui multa e juros de mora)
PAID_PARTIAL_OVERDUE	Parcialmente paga após o vencimento (inclui multa e juros de mora)
WAITING_PAYMENT	Pagamento iniciado mas ainda não confirmado pela instituição financeira

new_status

string

enum

required

Novo status da parcela após a mudança

Show Details

PENDING	Aguardando pagamento, ainda não vencida
PAID	Paga dentro do prazo e integralmente
OVERDUE_GRACE	Vencida sem pagamento; limite BNPL normal mantido; sem multas ou juros aplicados ainda
OVERDUE_PENALTY	Vencida além do período de carência; multas e juros acumulam diariamente
PAID_EARLY	Paga antes do vencimento (pode qualificar desconto)
PAID_PARTIAL	Parcialmente paga dentro do prazo
PAID_OVERDUE	Paga integralmente após o vencimento (inclui multa e juros de mora)
PAID_PARTIAL_OVERDUE	Parcialmente paga após o vencimento (inclui multa e juros de mora)
WAITING_PAYMENT	Pagamento iniciado mas ainda não confirmado pela instituição financeira

event_datetime

date-time

required

Timestamp quando a mudança de status ocorreu

data

object

required

Dados do evento com detalhes financeiros

Responses

200Webhook processado com sucesso

400Parâmetros da requisição inválidos