Consulta transações pelos critérios definidos

Este recurso possibilita a consulta das transações criadas dentro de um intervalo de datas específico, com a opção adicional de filtrar por tipo de pagamento e estado, se desejado.

Ao utilizar este método, é retornado um agrupamento das transações que correspondem aos filtros informados, fornecendo uma lista das transações que atendem aos critérios especificados.

Requisição

CampoTipoDescriçãoObrigatório
DataHoraInicialDataData/hora inicial de consultaSim
DataHoraFinalDataData/hora final de consultaSim
TipoTextoTipo da transação - Boleto, Cartao, Pix, Ted, SaldoWebConta, BoletoHibrido, OpenFinance, ManualSim
EstadoTextoEstado da transação - Pendente, Aprovada, Rejeitada, Cancelar, ACancelar, pendenteCobranca, acancelarCNAB, PendenteAntifraude, AnaliseAntifraude, ProcessarInstrucao, EmProcessamento, PagoeAberto, EstornarPIX, Estornado, ErroEstorno, Liquidado, FalhaCancelamento, CartaoPreAutorizado, CartaoCancelametoFuturo, ErroGerarPixBHNão
TipoFiltroTextoTipo do filtro para a consulta - dataemissao, datapagamento, checkoutNão

Resposta

CampoTipoDescrição
RetornoTextoRetorno da chamada, podendo possuir os valores OK ou ERRO
DetalhesErroTextoDetalhes do erro gerado, caso o retorno seja ERRO
TransacoesArray de ObjetosTransações que correspondem aos filtros informados na requisição
RetornoTextoRetorno da chamada, podendo possuir os valores OK ou ERRO
DetalhesErroTextoDetalhes do erro gerado, caso o retorno seja ERRO
IdentificadorGUIDIdentificador único da transação
TipoTextoTipo da transação - Boleto, Cartao, Pix, Ted, SaldoWebConta, BoletoHibrido, OpenFinance, Manual
EstadoTextoEstado da transação - Pendente, Aprovada, Rejeitada, Cancelar, ACancelar, pendenteCobranca, acancelarCNAB, PendenteAntifraude, AnaliseAntifraude, ProcessarInstrucao, EmProcessamento, PagoeAberto, EstornarPIX, Estornado, ErroEstorno, Liquidado, FalhaCancelamento, CartaoPreAutorizado, CartaoCancelametoFuturo, ErroGerarPixBH
TipoPagamentoTextoTipo do pagamento - naodefinido, boleto, cartao, pix, ted, SaldoWebConta, OpenFinance, Manual
MotivoCancelamentoTextoMotivo de cancelamento da transação, caso tenha sido cancelada
DataPagamentoDataData/hora de pagamento da transação
ValorNuméricoValor da transação destinado ao Marketplace ou Seller
ValorPagoNuméricoValor pago da transação, pode ser menor (no caso de descontos) ou maior(no caso de juros) que o valor original solicitado
ValorTaxasNuméricoValor total das taxas cobradas sobre a transação
DetalhesValoresObjetoDetalhamento dos valores de desconto, multa e juros da transação, caso houver
ValorDescontoNuméricoValor de desconto concedido na transação, caso tenha sido concedido algum desconto
ValorDesconto2NuméricoSegundo valor de desconto concedido na transação, caso tenha sido concedido algum desconto
ValorDesconto3NuméricoTerceiro valor de desconto concedido na transação, caso tenha sido concedido algum desconto
ValorMultaNuméricoValor de multa aplicado na transação, caso tenha sido aplicada alguma multa
ValorJurosNuméricoValor de juros aplicado na transação, caso tenha sido aplicado algum juros
ConfirmadaURLBooleanoIndica se a transação foi confirmada na URL do comércio
SplitsArray de ObjetosLista de “splits” relacionados à transação, indicando o código do cliente e o respectivo valor relacionado
ClienteIdGUIDIdentificador único do Cliente no PAY
ValorNuméricoValor da transação destinado ao Marketplace ou Seller
ValorRoyaltiesNuméricoValor da transação destinado ao Marketplace ou Seller, sobre o qual poderão incidir taxas, conforme a configuração prévia definida para o participante do split
DecisaoTextoInforma se o split já está aprovado ou não para efetivação da transferência para o recebedor - Pendente, Aprovado, Cancelado, Reprovado
ParcelasArray de ObjetosDetalhamento sobre as parcelas da transação, caso houver
NumeroNúmeroNúmero de parcelas
EstadoTextoEstado da parcela - Pendente, Aprovada, Rejeitada, Cancelar, ACancelar, pendenteCobranca, acancelarCNAB, PendenteAntifraude, AnaliseAntifraude, ProcessarInstrucao, EmProcessamento, PagoeAberto, EstornarPIX, Estornado, ErroEstorno, Liquidado, FalhaCancelamento, CartaoPreAutorizado, CartaoCancelametoFuturo, ErroGerarPixBH
MotivoCancelamentoTextoMotivo de cancelamento da parcela, caso tenha sido cancelada
DataPagamentoDataData de pagamento da parcela
ValorNúmeroValor da parcela
ConfirmadaURLBooleanoIndica se a parcela foi confirmada na URL do comércio
ClienteDescricaoTextoDescrição do cliente final da transação
ClienteIPTextoIP do cliente final da transação
ClienteCPFCNPJTextoCPF/CNPJ do cliente final da transação
ClienteNomeTextoNome do cliente final da transação
NumeroPedidoTextoNúmero do pedido e/ou carrinho de compras
CardTokenGUIDCódigo identificador do token do cartão
RecorrenteBooleanoIndica se o pagamento é recorrente
ContaBolsaoBooleanoIndica se os valores estão alocados em conta bolsao k8
ReferenciaTextoReferência para localização futura do boleto
DataLiquidacaoDataData em que os valores da transação foram disponibilizados ao recebedor
DataDisponibilizacaoDataData da disponibilização do valor ao recebedor
LiquidadoBooleanoIndica se foi realizada a liquidação da transação
EndToEndTextoExclusivo para transação do tipo pix, retornando o end to end da transação
LinhaDigitavelTextoLinha digitável para pagamento via boleto
CodigoBarrasTextoCódigo de barras para pagamento via boleto
NossoNumeroTextoNosso número de identificação do boleto
NumeroMovimentoFinanceiroTextoNúmero de identificação do movimento financeiro referente ao pagamento da transação, exclusivo para pix e boleto
QRCodeTextoTextoTexto do código Pix copia e cola / QR Code
CanalPagamentoNúmeroCanal por onde o pagamento foi realizado - "NaoDefinido = 0", "AgenciasPostosTradicionais = 1", "TerminalAutoAtendimento = 2", "Internet = 3", "Pix = 4", "CorrespondenteBancario = 5", "CentralAtendimento = 6", "ArquivoEletronico = 7", "DDA = 8", "CorrespondenteBancarioDigital = 9"
MeioPagamentoNúmeroMeio de pagamento utilizado na transação - "NaoDefinido = 0", "Especie = 1", "DebitoEmConta = 2","CartaoCredito = 3", "Cheque = 4"
ContaEmissaoTextoConta de emissão da transação
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

requisição de entrada

date-time
date-time
string
enum
string
enum
string
enum
Allowed:
Headers
string
required
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Response

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/json