Bem-vindo à documentação Pagar.me

Aqui você vai encontrar guias e exemplos para te ajudar
a integrar com a melhor API de Pagamentos do Brasil!

Começar

Você também pode buscar ou navegar pelas categorias

Chaves de acesso

Para usar todas rotas disponíveis em nossa API, você vai precisar de duas chaves numéricas. São elas a API Key e a Encryption Key.

Obs.: as duas são encontradas em sua Dashboard, nas versões de LIVE e TESTE, de acordo com o ambiente que você estiver usando.

Isto é, se você abrir a Dashboard no modo de produção (live), as chaves mostradas serão somente as de produção, já se alternar para o modo de teste (test), as chaves mostradas servem apenas para fazer testes com a nossa API, sem gerar transações reais.

Acesse essas informações na Dashboard pelo link: Chaves de API

API Key:

Essa chave é a mais importante para o nosso sistema, pois ela funciona como uma forma de autenticação intransferível para a sua empresa (company). Ela é obrigatória para que a sua aplicação consiga criar transações, planos, transferências etc. É extremamente importante que você mantenha essa chave segura, dada a sua sensibilidade.

Exemplo de api key para produção: ak_live_qlSlEXJgsqaCjKohh5AZfnqv7OLP5Q
Exemplo de api key para teste: ak_test_grXijQ4GicOa2BLGZrDRTR5qNQxJW0

Encryption Key:

Essa chave tem um nível de acesso menor do que o da API Key. Ela também serve como uma forma de autenticação, mas você pode usá-la apenas em duas operações: autorização de transações e geração de chaves públicas para encriptação de dados.

Exemplo de encryption key para produção: ek_live_Wa8CDUuLlFvSQzjxf4YFZIBQvb2l1p
Exemplo de encryption key para teste: ek_test_aHGru3d5a7qweiftqXg1bQvbN1c7K0

🚧

Ambiente de teste e produção

Atenção! Operações feitas usando uma chave de teste não geram recebíveis reais. Se você quiser criar transações reais, é preciso usar uma chave de produção.

❗️

Chave de Casa

Pense que sua chave de api, e de criptografia, são as chaves de sua casa. Você compartilharia a chave de sua casa com qualquer um?
Mantenha suas chaves de api em sigilo, e não compartilhe com ninguém, são dados sensíveis aos quais apenas você deve ter acesso.

Updated 3 years ago


Próximo

Overview

Chaves de acesso


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.