Consulta de Transações por Intervalo de Datas - PagSeguro Desenvolvedores
Esta consulta permite obter as transações recebidas por você em um intervalo de datas. Ela pode ser usada periodicamente para verificar se o seu sistema recebeu todas as notificações de transações enviadas pelo PagSeguro, de forma a conciliar as transações armazenadas em seu sistema com o PagSeguro.
Para consultar transações por intervalo de datas, você deve fazer uma requisição à API de Consulta de Transações, informando o intervalo desejado. O PagSeguro irá retornar todas as transações direcionadas para sua conta que foram criadas nesse intervalo. Veja abaixo um exemplo de chamada a essa API, que requer a utilização do protocolo HTTP e o método GET (as linhas foram quebradas para facilitar a leitura).
Observação Para utilizar a Sandbox PagSeguro para realizar a homologação da sua requisição, utilize o endpoint: https://ws.sandbox.pagseguro.uol.com.br/v2/transactions ao invés de https://ws.pagseguro.uol.com.br/v2/transactions
?initialDate=2011-01-01T00:00
&email=suporte@lojamodelo.com.br
initialDate Data inicial do intervalo.
Especifica a data inicial do intervalo de pesquisa. Somente transações criadas a partir desta data serão retornadas. Esta data não pode ser anterior a 6 meses da data corrente.
Formato: YYYY-MM-DDThh:mm, o formato oficial do W3C para datas. Veja mais sobre formatação de datas.
finalDate Data final do intervalo.
A diferença entre initialDate e finalDate não pode ser superior a 30 dias.
page página de resultados a ser retornada.
O Número de resultados retornado pela consulta por intervalo de datas pode ser grande, portanto é possível fazer a paginação dos resultados. A primeira página retornada é 1 e assim por diante. Este parâmetro especifica qual é a página de resultados a ser retornada.
maxPageResults Número máximo de resultados por página.
Para limitar o tamanho da resposta de cada chamada à consulta, é possível especificar um número máximo de resultados por página. Este parâmetro permite especificar este limite.
Formato: Inteiro entre 1 e 1000.
E-mail associado à conta PagSeguro que está realizando a chamada à API.
Token correspondente á conta PagSeguro que está realizando a chamada à API. Para criar um token para sua conta PagSeguro, acesse a página de configurações de pagamentos.
A resposta da consulta de transações por intervalo de datas é dada em formato XML. Nem todos os detalhes das transações são retornados por esta consulta; use a consulta de transações por código para obter mais detalhes, caso necessário. Veja uma resposta no exemplo abaixo.
<reference>REF5678</reference>
<transactionSearchResult> Este campo é a raiz do XML de resposta e engloba os dados dos resultados da consulta.
<date> Data da consulta.
Informa o momento em que a consulta foi realizada.
<currentPage> Índice da página atual.
Informa o índice da página de resultados sendo consultada. A primeira página de resultados é a de número 1 e assim por diante.