![Multiplus Card [Docs]](https://docs.multipluscard.com.br/images/logo.png){kind=logo}
Title here
Summary here
Transações
Consulte todas as transações realizadas pelo PINPDV, independente do módulo de origem.
Consulta em lote por período — pronta para conciliação de recebíveis.
Venda e transação
No PINPDV, a consulta de transações é feita pela consulta de venda — não existe um endpoint que devolva transações soltas. A venda é a entidade principal e a transação é sempre um item dela.
- Uma venda pode ter mais de uma transação (ex.: pagamento dividido em débito + Pix). O array
transacoesde cada venda reúne todas elas, com NSU, autorização, bandeira, adquirente e status individuais. - Toda venda tem uma origem, indicada pelo campo
tipoVenda: Avulsa, Expressa, PreVenda ou PosVenda (TEF Mobile). É a origem que define como a venda foi iniciada e quais fluxos se aplicam a ela.
Por isso o filtro, a ordenação e o retorno desta consulta são sempre no nível da venda; as transações vêm aninhadas em cada resultado.
Endpoint
| Método | Endpoint | Descrição |
|---|---|---|
GET | /venda | Consultar vendas (e suas transações) com filtros |
Parâmetros disponíveis
| Parâmetro | Tipo / Valores | Descrição |
|---|---|---|
DataInicial | YYYY-MM-DDTHH:MM:SS | Início do período |
DataFinal | YYYY-MM-DDTHH:MM:SS | Fim do período |
FiltroTipoVenda | Avulsa, Expressa, PreVenda, PosVenda | Tipo de venda |
FiltroStatus | Realizada, Cancelada, Error | Status da venda |
FiltroTipoPagamento | Dinheiro, Credito, Debito, Pix, Crediario | Meio de pagamento |
FiltroPinPdv | Código do dispositivo | Smart POS específico |
PaginaNumero | Inteiro | Página (padrão: 1) |
QtdRegistro | Inteiro | Registros por página (padrão: 100) |
OrdenarPor | Id, Valor, Identificador, Status, TipoVenda, CadastradoEm, AtualizadoEm | Campo de ordenação |
OrdenarTipo | ASC, DESC | Direção |
curl --request GET \
--url 'https://api.pinpdv.com.br/venda?DataInicial=2024-12-12T00:00:00&DataFinal=2024-12-12T23:59:59' \
--header 'Authorization: Bearer {SEU_TOKEN}'Exemplo de resposta
A resposta usa o envelope de paginação, e cada item de data é uma venda com suas transacoes aninhadas. Os campos preVenda e posVenda indicam a origem quando a venda veio desses módulos.
200 - OK
{
"paginaAtual": 1,
"itensPorPagina": 100,
"quantidadeDePaginas": 1,
"quantidadeTotalDeItens": 1,
"paginaAnterior": false,
"paginaProxima": false,
"data": [
{
"id": 516464,
"identificador": "300b09ef4c77412bb8a2f1529522a1e1",
"tipoVenda": { "key": 3, "value": "PosVenda" },
"valor": 100.11,
"comprovante": null,
"isDocumento": false,
"cadastradoEm": "2026-04-30T14:59:58.573",
"status": { "key": 0, "value": "Realizada" },
"transacoes": [
{
"id": 256657,
"valor": 100.11,
"parcelas": 1,
"status": { "key": 0, "value": "Aprovada" },
"tipoPagamento": 3,
"pagamentoTipo": { "key": 3, "value": "Debito" },
"dados": {
"dataHora": "2026-04-30T15:00:00.688",
"nsu": "000000153",
"autorizacao": "164550",
"bandeira": "MASTERCARD",
"adquirente": "Getnet"
},
"adquirenteAdicional": {}
}
],
"produtos": [],
"preVenda": null,
"posVenda": { "id": 61239, "identificador": "61239-pedido-001" },
"pinPdv": { "id": 1, "codigo": "526989", "nome": "CAIXA 01" },
"isCancelamento": false
}
]
}Campos podem variar
O bloco adquirenteAdicional é específico do adquirente e pode vir vazio ({}). Novos campos podem ser adicionados às respostas — ignore campos desconhecidos em vez de tratá-los como erro.
Anterior
ProdutosPróximo
Adquirentes e Terminais