> ## Documentation Index > Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt > Use this file to discover all available pages before exploring further. # Pagamentos vs. transações > A diferença entre pagamento e transação na Chargefy: a venda como o comprador viveu e os lançamentos que ela produz no seu extrato, com taxas e liquidação. 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. | | Pagamento (`payment_intent`) | Transação (`transaction`) | | ---------------- | ------------------------------------ | ----------------------------------------- | | Responde | "Essa venda foi paga?" | "Quanto entra na minha conta e quando?" | | Unidade | A venda inteira | Cada movimento de dinheiro | | Quantidade | Um por venda | Um por parcela, por taxa e por estorno | | Valor negativo? | Nunca | Sim: saída de dinheiro tem sinal negativo | | Prefixo do ID | `pi_` | `txn_` | | Escrita pela API | Criar, confirmar, capturar, cancelar | Nenhuma — é somente leitura | ## 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: ```json theme={"theme":"css-variables"} { "id": "pi_M2nQ7xW4pL9kR3sT", "object": "payment_intent", "amount": 110000, "installments": 10, "principal_amount": 100000, "installment_interest_amount": 10000, "status": "succeeded", "...": "demais campos do pagamento" } ``` 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: ```json theme={"theme":"css-variables"} { "id": "txn_9fK2mQ4xW7pLnR8s", "object": "transaction", "amount": 11000, "available_at": "2026-09-19T00:00:00Z", "description": "Installment 2/10", "fee_amount": 1399, "fee_details": [ { "amount": 1000, "description": "Installment interest", "type": "installment_interest" }, { "amount": 399, "description": "Chargefy processing fee", "type": "chargefy_fee" } ], "installment": 2, "installment_count": 10, "net_amount": 9601, "payment_intent": "pi_M2nQ7xW4pL9kR3sT", "source": "ch_Q7xW4pL9kR3sTM2n", "status": "pending", "type": "charge", "...": "demais campos da transação" } ``` Repare no que muda de um objeto para o outro: | Pergunta | Onde está a resposta | | --------------------------------- | ---------------------------------------------------------- | | Quanto o comprador pagou? | `payment_intent.amount` — R\$ 1.100,00, uma vez só | | Em quantas vezes? | `payment_intent.installments` — 10 | | Quanto entra na conta a cada mês? | `transaction.net_amount` — R\$ 96,01 por parcela | | Quanto foi de taxa? | `transaction.fee_amount` e a quebra em `fee_details` | | Quando o dinheiro cai? | `transaction.available_at`, e `settled_at` quando liquidar | **A conta sempre fecha** `net_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. ```json theme={"theme":"css-variables"} { "id": "txn_9fK2mQ4xW7pLnR8s", "object": "transaction", "amount": -5000, "fee_amount": 0, "net_amount": -5000, "source": "re_8sT4nK2wQ7xLpR9m", "type": "refund", "...": "demais campos da transação" } ``` 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 | `type` | O que é | | -------------- | ------------------------------------------------------------------------ | | `charge` | Uma parcela de venda entrando na conta. | | `refund` | Um estorno saindo da conta. Valor negativo. | | `chargefy_fee` | A remuneração da Chargefy naquela parcela. | | `platform_fee` | A remuneração da plataforma, quando a venda acontece por uma plataforma. | | `adjustment` | Um acerto pontual lançado no extrato. | 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 Tudo que é venda: liberar pedido, mostrar o valor cobrado, explicar o parcelamento ao cliente, decidir se houve ou não pagamento. 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: | Campo | Aponta para | Serve para | | ---------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------- | | `payment_intent` | O pagamento (`pi_*`) | Chegar na venda: cliente, parcelas, produto | | `source` | A cobrança (`ch_*`) ou o reembolso (`re_*`) que causou o movimento | Agrupar: todos os movimentos com o mesmo `ch_*` são a mesma cobrança | 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 | Campo | O que é | | -------------- | ----------------------------------------------------------------------------------------------------------------- | | `available_at` | A **previsão** de liquidação. Pode ser `null` enquanto depende de conciliação. | | `settled_at` | A data em que o dinheiro **efetivamente** entrou. `null` enquanto pendente. | | `status` | `pending` (não liquidou), `paid` (liquidou), `canceled` (não vai liquidar) ou `refunded` (a venda foi estornada). | 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 Contrato completo: campos, tipos, sinais, fee\_details e liquidação. Como fechar o extrato com o que foi vendido. O processo da venda e cada tentativa dentro dele. O que muda no valor cobrado e no que você recebe.