Conciliação e relatórios

Um conciliador contínuo compara três fontes de verdade — as observações da cadeia, os valores que cada intenção espera e a entrega dos webhooks — e registra tudo o que não bate como uma divergência.

Tipos de divergência

kind	Gerada quando
underpaid	O valor confirmado está abaixo da cotação
overpaid	O valor confirmado excede a cotação
late_payment	Uma transferência chegou após a expiração
post_settlement_payment	Chegaram fundos a um endereço depois que a intenção dele já estava confirmada
asset_mismatch	Uma transferência de um ativo não registrado ou diferente chegou ao endereço de uma intenção
reorg_pending	Uma evidência foi removida por uma reorganização e não foi observada de novo
webhook_undelivered	Uma intenção foi confirmada, mas nenhuma entrega de payment.confirmed teve sucesso
stale_in_flight	Uma intenção ficou em detected/confirming/reorged por tempo fora do normal
allocation_mismatch	As alocações e os totais da intenção não coincidem
custody_uncredited	Chegaram fundos à carteira Bitcart da plataforma para uma fatura que não foi concluída (um pagamento parcial ou atrasado). Eles não são creditados automaticamente; um operador verifica as transações e credita o valor informado pela Bitcart
payout_attention	Um saque falhou depois de possivelmente ter sido transmitido. O valor continua retido até que um operador confirme com a Bitcart que nada foi enviado

As divergências ficam open, acknowledged ou resolved. Resolver uma divergência no painel exige uma nota e é registrado no log de auditoria; isso nunca edita a evidência da cadeia subjacente.

GET/v1/reports/reconciliationlive · após ativação da conta

Relatório de pagamentos

GET/v1/reports/payments?from=…&to=…&format=csvlive · após ativação da conta

CSV por padrão (ou format=json). Os timestamps estão em UTC. Cada linha traz o id da intenção, os horários de criação/confirmação, status e motivo, valor e moeda fiduciários, o id do seu pedido, a rede/ativo/valor cotados e a fonte da taxa, as unidades base recebidas e creditadas, os hashes das transações e a taxa da plataforma registrada para aquela intenção.

Como ler os números corretamente

• O volume processado (GMV) é o valor fiduciário das intenções confirmadas. Ele não é receita da plataforma e não é o valor que o FeitPay mantém para você: o que é mantido para você é o seu saldo em custódia por ativo, descontados os saques (GET /v1/balances).
• As taxas da plataforma são medidas por intenção confirmada de acordo com a versão imutável da sua tabela de taxas e cobradas de você mensalmente; veja GET /v1/billing/usage e GET /v1/billing/invoices. Enquanto a sua conta não estiver ativada, nenhum pagamento é processado para ela e, portanto, nada é medido.
• Os valores recebidos são o que a Bitcart informa para cada fatura da conta da plataforma. Quando uma fatura é concluída, o valor é creditado ao seu saldo em custódia exatamente uma vez, e você o retira por meio de saques. Veja Custódia.
• Observações duplicadas nunca são contadas duas vezes: cada transferência tem no máximo uma alocação, e cada fatura é creditada no máximo uma vez.