{"id":1388,"date":"2017-11-01T20:18:31","date_gmt":"2017-11-01T22:18:31","guid":{"rendered":"http:\/\/maxipago.com\/developers\/?page_id=1388"},"modified":"2026-03-05T17:26:58","modified_gmt":"2026-03-05T20:26:58","slug":"consulta-transacao","status":"publish","type":"page","link":"https:\/\/www.maxipago.com\/developers\/apidocs\/consultas\/consulta-transacao\/","title":{"rendered":"Consultar Transa\u00e7\u00e3o"},"content":{"rendered":"\n

A sondagem de uma \u00fanica transa\u00e7\u00e3o permite verificar o seu status e resgatar os detalhes de uma transa\u00e7\u00e3o. Esta sonda \u00e9 necess\u00e1ria para confirmar os pagamentos de pedidos feitos com boletos, al\u00e9m de verificar a situa\u00e7\u00e3o de um estorno solicitado anteriormente.<\/p>\n\n\n\n

Para filtrar uma \u00fanica transa\u00e7\u00e3o deve-se usar o elemento <filterOptions\/><\/code>, dentro da tag <request\/><\/code>:<\/p>\n\n\n\n

<\/div>\n\n\n\n

Controle de Rate Limit na API de Relat\u00f3rios<\/h2>\n\n\n\n

O rate limit \u00e9 um mecanismo que define o n\u00famero m\u00e1ximo de requisi\u00e7\u00f5es que podem ser realizadas em um determinado intervalo de tempo. Ele serve para proteger as aplica\u00e7\u00f5es contra excesso de chamadas e garantir a estabilidade dos servi\u00e7os.<\/p>\n\n\n\n

Na API de relat\u00f3rios do gateway maxiPago!, o rate limit determina quantas requisi\u00e7\u00f5es podem ser feitas por segundo em cada rota. Caso o limite seja ultrapassado, o sistema retorna o erro 429 com a mensagem: \u201cRate limit excedido para merchant_id=xxxxx\u201d, onde xxxxx corresponde ao identificador da loja (merchant id) no maxiPago!.<\/p>\n\n\n\n

Segue abaixo o limite configurado para a rota de relat\u00f3rios:<\/p>\n\n\n\n

Rota<\/strong><\/td>M\u00e9todo<\/strong><\/td>Requisi\u00e7\u00f5es por tempo<\/strong><\/td><\/tr>
https:\/\/api.maxipago.net\/ReportsAPI\/servlet\/ReportsAPI<\/a><\/td>POST<\/td>60reqs\/60s<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Observa\u00e7\u00e3o:<\/strong> Caso a sua aplica\u00e7\u00e3o envio mais requisi\u00e7\u00f5es que o permitido no intervalo de tempo haver\u00e1 o bloqueio tempor\u00e1rio por 9 segundos restantes.<\/p>\n\n\n\n

\u00c9 importante observar esse limite ao integrar suas aplica\u00e7\u00f5es para evitar bloqueios tempor\u00e1rios de acesso \u00e0 API.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Consultar Transa\u00e7\u00e3o \u2013 URLs Para Envio dos Dados<\/span><\/p>\n\n\n\n

SANDBOX<\/strong>: https:\/\/testapi.maxipago.net\/ReportsAPI\/servlet\/ReportsAPI<\/p>\n\n\n\n

PRODU\u00c7\u00c3O<\/strong>: https:\/\/api.maxipago.net\/ReportsAPI\/servlet\/ReportsAPI<\/p>\n\n\n\n

\n \n \n \n \n \n <\/colgroup>\n <\/table>\n