Skip to main content
O pagamento é a venda como o comprador viveu: um valor, um parcelamento escolhido, um desfecho. A transação é a contabilidade: cada linha de dinheiro entrando ou saindo da sua conta, com a taxa descontada e a data em que liquida. Uma venda de R$ 1.100,00 em 10x é um pagamento e dez lançamentos no extrato. Confundir os dois é o motivo mais comum de um relatório de faturamento não bater com o extrato.

​
O exemplo que explica a diferença

Uma venda de R$ 1.100,00 em 10x com juros, aprovada no cartão. O pagamento registra a venda como ela foi vendida:
O extrato registra os dez movimentos que ela produz. Cada parcela é um lançamento próprio, com a sua fatia dos juros e da taxa:
Repare no que muda de um objeto para o outro:
A conta sempre fechanet_amount = amount - fee_amount, e fee_amount é exatamente a soma dos itens de fee_details. Somar net_amount de qualquer conjunto de movimentos dá o efeito líquido no seu saldo — sem inverter sinal por tipo, sem excluir estorno.

​
Entradas e saídas

Entradas são positivas, saídas são negativas. Um estorno de R$ 50,00 não altera a venda original: ele entra como um lançamento próprio, negativo.
A taxa da venda original não volta, então não há nada a deduzir do movimento de saída — por isso fee_amount é 0 e o líquido é o valor cheio do estorno.

​
O que cada tipo de movimento significa

Quais desses você recebe depende do papel da sua organização: quem vende vê as vendas e os estornos; uma plataforma vê também os movimentos de fee das organizações conectadas.

​
Para que serve cada um

Use o pagamento para

Tudo que é venda: liberar pedido, mostrar o valor cobrado, explicar o parcelamento ao cliente, decidir se houve ou não pagamento.

Use a transação para

Tudo que é dinheiro: fechar caixa, conferir taxas, projetar recebíveis, conciliar com o extrato bancário, apurar o líquido de um período.
Um teste rápido para saber qual usar: se a pergunta tem data de liquidação ou taxa na resposta, é transação. Se tem cliente, produto ou desfecho da venda, é pagamento.
Não some payment_intent.amount para descobrir quanto entrou na conta. Esse campo é o que o comprador pagou, e inclui juros de parcelamento que não são seus, e nada nele desconta a taxa. Para saldo, some net_amount das transações.

​
Como os dois se ligam

Toda transação de venda aponta para dois objetos: Para ver as dez parcelas de uma venda parcelada, liste as transações e agrupe pelo source. Para ir da linha do extrato até o cliente, siga o payment_intent.

​
Quando o dinheiro liquida

Compare available_at com settled_at para medir atraso de liquidação. Movimentos canceled não entram em soma de saldo: a cobrança de origem não se concretizou.

​
Perguntas frequentes

Sim, quando ele efetivamente move dinheiro. Um pagamento cancelado antes de qualquer tentativa não produz lançamento nenhum.
Porque os juros de parcelamento entram no bruto de cada parcela. Eles são dinheiro que passa pela sua conta mas não é seu — por isso aparecem em fee_details como installment_interest e saem do net_amount.
Não. A transação da venda continua no extrato como aconteceu, com status refunded, e o estorno entra como um lançamento negativo separado. O extrato reflete o dinheiro se movendo, não a venda como um todo.
Em fee_details, dentro do movimento da parcela. Numa venda por plataforma, o lojista vê apenas a taxa da plataforma (platform_fee): como essa taxa se divide entre a plataforma e a Chargefy pertence ao movimento da plataforma, não ao dele.

​
Próximos passos

Objeto transaction

Contrato completo: campos, tipos, sinais, fee_details e liquidação.

Conciliar pagamentos

Como fechar o extrato com o que foi vendido.

Pagamentos vs. cobranças

O processo da venda e cada tentativa dentro dele.

Repassar a taxa ao comprador

O que muda no valor cobrado e no que você recebe.