Diferença entre Orders x Charges
Para entender o essencial da API de Pagamentos da Barte, é importante conhecer os principais objetos que compõem o fluxo transacional na nossa plataforma. Aqui vai um resumo claro e prático:
📌 Conceitos Fundamentais
1. Buyer
O "Buyer" é o comprador na transação — ou seja, o pagador. Na API, é a pessoa física ou jurídica que irá efetuar o pagamento de uma cobrança gerada pelo seller. É o titular do meio de pagamento (cartão, boleto, PIX) e seus dados são capturados ou referenciados na hora da criação da cobrança.
Exemplo de uso: Nome, CPF/CNPJ, e-mail, telefone, endereço.
2. Order
A "Order" representa a intenção de pagamento ou a venda feita pelo seller. É o registro que une os produtos/serviços vendidos com o comprador e define os termos dessa venda (valor total, número de parcelas, vencimentos, etc.).
Exemplo de uso: Uma venda de R$ 1.500 parcelada em 6x feita via link de pagamento.
3. Charge
A "Charge" é a cobrança monetária efetiva gerada a partir da Order. Ela representa a execução do pagamento — e pode ter status como pendente, paga, recusada, em análise, estornada, etc.
Exemplo de uso: A cobrança gerada para um cartão de crédito, com valor de R$ 250/mês por 6 meses.
É pela charge que você faz o Estorno
🧩 Relação entre os Objetos
O Buyer é quem paga.
A Order define o que está sendo comprado, como e quando será cobrado.
A Charge é a execução concreta do pagamento.
Atualizado
Isto foi útil?