❗️

Atenção: Essa versão de API será descontinuada

Essa versão da API Pagar.me já não é mais atualizada e, em breve, deixará de funcionar. Para que sua loja possa vender sem problemas, você precisa realizar sua integração usando a versão mais recente da nossa API, a V5.

No canto superior esquerdo da tela é indicado qual versão da documentação você está vendo. Clique na seta onde indica a versão e altere para a V5 para acessar a documentação.

Se você já é cliente, precisa realizar obrigatoriamente a migração para a versão V5.

Em caso de dúvidas, basta entrar em contato com o nosso time de atendimento através do e-mail, enviando a sua dúvida para [email protected] e por telefone, ligando para 4004-1330. Se você já é cliente pode também entrar em contato através do chat dentro da sua Dashboard.

📘

Filtros de objetos

Para filtrar por chaves nested de objetos usa-se a sintaxe de chaves. Por exemplo:

Shell

curl -X GET https://api.pagar.me/1/transactions \
-d 'api_key=SUA_API_KEY'
-d 'metadata[chave]=valor'

📘

Filtros de range

Todos os filtros mencionados podem ser usados para buscas em ranges usando os prefixos:

Prefixo	Significado
<	menor que
>	maior que
<=	menor ou igual a
> =	maior ou igual a

Por exemplo, para buscar em um range de date_created:

Shell

curl -X GET https://api.pagar.me/1/transactions \
-d 'api_key=ak_test_grXijQ4GicOa2BLGZrDRTR5qNQxJW0'
-d 'date_created=>=1483236000000'
-d 'date_created=<=1484689847590'

Para campos que sejam strings, a comparação é lexicográfica, letras maiúsculas sendo 'maiores' que minúsculas.

🚧

Filtros de data

É importante notar que a filtragem por data utiliza unixTimeStamp para representá-la. Para gerar o unixTimeStamp de uma data, é possível utilizar o console do Google Chrome e utilizar o seguinte código em Javascript : new Date("2017-12-25T02:00:00.000Z").getTime() que retornará 1514167200000

🚧

Rate Limit

Essa rota possui um limite de requisições.
Caso você ultrapasse esse valor será retornado o erro “StatusCode 429” por nossa API.

Para saber qual o limite dessa e demais rotas acesse : Rate Limit