🔄 Processo de Liquidação e Conciliação de Transações

O processo de liquidação na Paytime é realizado por parcela, e não de forma consolidada por transação. Por esse motivo, a conciliação financeira deve ser implementada pelo integrador.

📌 Campo expected_on
No detalhe da transação, o campo expected_on contém um array com as informações previstas de liquidação, incluindo:

amount:valor que será liquidado

date: data prevista para a liquidação da parcela

Esse array representa quando e quanto será liquidado ao longo do tempo, especialmente em transações parceladas ou não antecipadas.

🧮 Regra de Conciliação

A lógica de conciliação deve ser baseada no campo expected_on, considerando:

• A liquidação ocorre por parcela
• Transações não antecipadas são liquidadas mensalmente
• O valor liquidado em um determinado dia deve corresponder à soma dos valores das parcelas (expected_on.amount) com data igual à data da liquidação

🔔 Atualizações via Webhook

Para acompanhar a evolução da liquidação:

• Sempre que uma parcela for liquidada, o status correspondente dentro do array expected_on será atualizado
• Nesse momento, será disparado o webhook: updated-sub-transaction

Recomenda-se:

• Armazenar as transações do banco de dados do integrador
• Atualizá-las sempre que um webhook for recebido
• Associar o ID da transação Paytime ao seu identificador interno
• Utilizar essas informações para cálculo e conciliação financeira

Esse modelo é o mesmo utilizado pela Paytime na integração com adquirentes.

📊 Consulta de Liquidação

Através da rota:

GET /v1/marketplace/liquidations/extract

é possível obter:

• Valor total pago na liquidação
• Conta bancária de destino do pagamento

⚠️ Essa rota não informa as transações individualmente.

✅ Conferência do Valor Liquidado

Para validar o valor de uma liquidação:

1. Identifique a data da liquidação
2. Some todos os valores do array expected_on.amount cuja data (expected_on.paid_at) corresponda à data da liquidação
3. Compare o total com o valor retornado no extrato de liquidação

Se os valores forem equivalentes, a liquidação está conciliada corretamente.