Recebíveis tomados por outras instituições

Este guia explica o webhook receivable_unit.contract.settlement e como reagir a ele.

O cenário

Um seller do seu marketplace pode ter cedido os recebíveis futuros a outra instituição — seja como garantia (cessão fiduciária) ou por venda definitiva (cessão definitiva).

Quando isso acontece, os valores daquele vendedor (seller) podem ser liquidados (pagos) diretamente na outra instituição, e não na conta de pagamento do BaaS Zoop.

O risco para o Marketplace

Se o seller transacionar nessa situação:

O recebível pode não ser custodiado na Zoop, pois ele pode não ser liquidado na conta pagamento criada, mas sim em outra instituição.
O repasse condicionado à entrega pode ser comprometido: você pode não conseguir reter o valor e liberá-lo quando o seller cumprir a entrega.
Você fica exposto a um seller cuja receita já está comprometida com terceiros.

Como funciona a notificação

Diariamente, após as 19h30, a Zoop identifica os efeitos de contrato a liquidar no próximo dia útil e publica um evento receivable_unit.contract.settlement para cada seller afetado. A data de liquidação exata de cada unidade vem no campo unit.settlement_date.

Pré-requisito
O seller precisa ter feito opt-in da própria agenda de recebíveis para o marketplace, por meio da última versão do termo de aceite. Sem o opt-in, o evento não é gerado para aquele seller.

O que fazer ao receber o evento

A Zoop apenas notifica — não bloqueia automaticamente a transação. A decisão é do seu marketplace:

Identifique o seller — payload.object.seller
Entenda o efeito — type (lien_cession/definitive_cession), amount (valor/percentual) e unit.settlement_date
Decida a política — bloquear novas transações, seguir transacionando ciente do risco, ou renegociar com o seller.

Exemplo de decisão

Situação	Ação sugerida
Seller com `lien_cession` ativa	Restrinja ou bloqueie transações até regularizar
Seller com `definitive_cession`	Avalie interromper a operação com o seller
Efeito com `settlement_date` distante	Monitore; risco menor no curto prazo

Importante | Política de Risco
A decisão final é do Marketplace. O webhook entrega a informação; a política de risco e decisão se vai querer transacionar com vendedor com recebível comprometido é do marketplace.
Nosso time está 100% disponível para maiores esclarecimentos e consultas para essa decisão.

Para mais informações sobre esse webhook e todos campos retornados, acesse o Catálogo de Webhooks, na seção Eventos de Agenda de Recebíveis (efeitos de contrato).