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

Buyer → realiza uma Order → que gera uma Charge

• 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.