Autenticação


Antes de começar, você precisa obter suas chaves de API.
Para isso, siga os seguintes passos:
1 - Acesse este link e faça login com seu usuário,
2 - Após acessar o Dash, navegue até a área de Desenvolvimento e em seguida clique em Chaves.

📘

Clientes integrados na versão anterior da API

Caso você já seja cliente Pagar.me e esteja integrado na versão anterior da API, entre em contato com o nosso time de suporte.

🚧

Endpoints para teste e produção

As chamadas de testes e de produção devem ser feitas para o mesmo endpoint: https://api.pagar.me/core/v5.

O que definirá se a transação irá utilizar o nosso simulador ou se seguirá o fluxo de produção é o tipo da Chave de API enviada.

Tipos de Chave

Nós disponibilizaremos 02 chaves para que você possa realizar testes:

  • Exemplo de prefixo da Chave Secreta de Sandbox: sk_test_*
  • Exemplo de prefixo da Chave Pública de Sandbox: pk_test_*

Após o fechamento do contrato o cliente receberá as chaves do ambiente de produção:

  • Exemplo de prefixo da Chave Secreta de Produção: sk_*
  • Exemplo de prefixo da Chave Pública de Produção: pk_*

Autorização Basic Auth

Para se autenticar conosco você deve enviar a Chave de API no cabeçalho Authorization, seguindo o padrão da HTTP Basic Authentication.

📘

Como utilizar a SecretKey

Para montar a requisição Basic Auth, você deve utilizar a SecretKey da seguinte maneira:
User: SecretKey
Password: vazio

📘

Chave Pública de API (PK)

Essas chaves serão utilizadas para representar a sua loja na integração com o checkout.
❗️ NÃO COMPARTILHE SUAS CHAVES DE API

A sua chave da API é SECRETA e não deve ser compartilhada com terceiros.