These docs are for v4. Click to read the latest docs for v5.

Retornando um objeto Order

Objeto Order

ParâmetroDescrição
amountValor total do link de pagamento
idID do pedido criado
company_idID da company que criou o link
statusStatus do link de pagamento.
created para orders criados e abandonados ou transações recusadas
paid para pedidos criados e pagos
itemsItens do pedido. Referência:
payment_link_idId do link de pagamento que originou o pedido

❗️

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.

📘

Exemplo de paginação utilizando cursor

A primeira requisição da paginação não contém o parâmetro cursor visto que ainda nenhum token foi retornado. Segue abaixo o exemplo da primeira requisição:

curl -X GET https://api.pagar.me/1/orders \
-d 'api_key=SUA_API_KEY'

No retorno da requisição anterior, será retornado nos headers da resposta os parâmetros x-cursor-previouspagr e x-cursor-nextpage, onde o primeiro será vazio (porque não existe uma pagina anterior no momento) e o segundo conterá o Token de acesso a próxima página.

Dito isto, para acessar a próxima página da listagem, devemos informar dentro do campo cursor o Token retornado no parâmetro x-cursor-nextpage da resposta, como mostra a requisição abaixo:

curl -X GET https://api.pagar.me/1/orders \
-d 'api_key=SUA_API_KEY'
-d 'cursor=TOKEN_RETORNADO_NO_CURSOR_NEXTPAGE'

Para ir avançando para as próximas páginas da listagem, basta ir substituindo o Token passado no parâmetro cursor pelo Token retornado em casa resposta da requisição.

Para consultar a página anterior de uma listagem seguimos a mesma estrutura, onde o que muda é apenas o Token informado no parâmetro cursor, como mostra o exemplo abaixo:

curl -X GET https://api.pagar.me/1/orders \
-d 'api_key=SUA_API_KEY'
-d 'cursor=TOKEN_RETORNADO_NO_CURSOR_PREVIOUSPAGE'

🚧

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

Language
Credentials
Query
Click Try It! to start a request and see the response here!