API Reference
GuidesSuporteAPI Reference

Autenticação

Obtendo sua Chave de API


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. 

var fs = require('fs');
const request = require("request");
var body = JSON.parse(fs.readFileSync('body.json', 'utf8'));

var options = {                 
    method: 'POST',             
    uri: 'https://api.pagar.me/core/v5/orders',                    
    headers: {               
      'Authorization': 'Basic ' + Buffer.from("sk_test_*:").toString('base64'),
      'Content-Type': 'application/json'              
    },
    json : body
};    

request(options, function(error, response, body) {  
    console.log(response.body);
});

📘

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.