Informações gerais

Uma Venda representa uma cobrança criada pelo estabelecimento para receber um determinado valor de um comprador.

Ela concentra as informações da cobrança e acompanha todo o seu ciclo, desde a criação até sua conclusão, cancelamento ou expiração.

A Venda também pode envolver um ou mais meios de pagamento, permitindo que seu valor seja pago utilizando diferentes formas de pagamento.

Relação entre Vendas e Transações

Apesar de estarem relacionadas, Venda e Transação representam conceitos diferentes.

Venda: representa o valor que deve ser pago ou que já foi pago.
Transação: representa uma tentativa de pagamento realizada para aquela venda.

Uma mesma venda pode possuir uma ou mais transações ao longo do seu ciclo.

Dessa forma, o status da venda representa a situação geral da cobrança, enquanto as transações registram individualmente o resultado das tentativas de pagamento.

📘
Em resumo. podemos visualizar a relação da seguinte forma:

A Venda define o que deve ser pago

Possui uma ou mais transações

Cada Transação representa uma tentativa de pagamento

📘
Venda não é a mesma coisa que Transação
A Venda responde “qual é a situação da cobrança?”. A Transação responde “o que aconteceu nesta tentativa ou operação de pagamento?”.

Meios de pagamentos

Uma venda pode ser paga utilizando os meios de pagamento disponibilizados ao estabelecimento.

Dependendo da configuração e fluxo utilizado, uma venda também pode envolver mais de um meio de pagamento, permitindo que o valor seja dividido entre diferentes formas de pagamento.

Ou seja, isso traz a possibilidade de centralizar em uma unica venda, diversos pagamentos com vários meios, possibilitando por exemplo, pagar com um ou dois cartões, ou fazer combinações com Pix e Boleto.

📘
Nomenclaturas
Em nossa Documentação, BackOffice e API você vai encontrar
Venda - charge
Transações - transactions

Tipos de Venda

As Vendas são classificadas por tipo, que determina a finalidade da cobrança e como ela será processada.

Atualmente, existem três tipos:

Pagamento: utilizado para realizar uma cobrança diretamente.
Link de Pagamento: utilizado para disponibilizar um checkout por meio de um link.
Tokenização: utilizado para armazenar de forma segura os dados do cartão para utilização posterior.

Na API, essa definição é feita pelo campo type, com valores como PAYMENT, PAYMENTLINK e TOKENIZATION.

No BackOffice, são exibidos os tipos Pagamento e Link de Pagamento. A Tokenização está disponível apenas através da integração via API.

A tabela abaixo apresenta a correspondência entre os tipos exibidos no BackOffice e os valores utilizados pela API.

BackOffice	`type`	Descrição
Pagamento	`PAYMENT`	Realiza uma cobrança direta utilizando o meio de pagamento selecionado, seja Cartão, Boleto ou Pix.
-	`TOKENIZATION`	Realiza uma verificação e tokeniza os dados do cartão para que possam ser utilizados posteriormente. Disponível apenas para Cartão.
Link de Pagamento	`PAYMENTLINK`	Gera um link com checkout para que o comprador realize o pagamento.

🚧
BackOffice - TOKENIZATION
As vendas do tipo TOKENIZATIONnão são exibidas no BackOffice, pois esse tipo é utilizado exclusivamente através da integração via API.