Você está na versão correta da documentação?
Verifique na sua Dashboard a versão da API que você está usando. Você deve usar a documentação correspondente. Para saber mais, veja: Versionamento.
Bem-vindo ao guia de referências da API do Pagar.me! É através desta API que você irá integrar seu sistema ao nosso, e, além disso, você também pode recriar as funcionalidades existentes na nossa dashboard, que são feitas consumindo a API que será aqui descrita.
Nossa API é RESTful, e todas suas respostas são em JSON, no endpoint base:
https://api.pagar.me/1/
A seguir, algumas convenções de nossa API:
Paginação
Cuidado com o limite máximo do
count
O parâmetro
count
possui um limite máximo de 1000, caso seja passado um valor maior que esse a api retornará um erro.
Há muitas rotas de listagem de entidades na api. Em todas elas é necessário lidar com um sistema de paginação para percorrer todas as instâncias. Esse sistema refere-se aos parâmetros count
e page
. Count representa quantos resultados por página deverão ser retornados e se não for informado, o valor padrão é 10, e seu limite é 1000. Page é a página a ser retornada e se não for informado, o valor padrão é 1.
Autenticação
Sempre que sua aplicação chamar algum de nossos endpoints, deve ser passado como forma de autenticação sua API KEY, chave que pode ser encontrada em sua Dashboard.
A api_key pode ser informada de três forma diferentes:
1 - No corpo da requisição como valor do parâmetro api_key
2 - Na url (query param) como valor do parâmetro api_key
3 - Basic Auth com username igual à chave e senha igual a x
(xis minúsculo)