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.
Tipos de Chave
Com a conclusão do processo de credenciamento, serão enviadas as chaves, porém, você também pode visualizá-la via dashboard Pagar.me, conforme orientado neste link:
- Exemplo de prefixo da Chave Secreta de Produção:
sk_* - Exemplo de prefixo da Chave Pública de Produção:
pk_*
Estrutura de Credenciais
O Connect Stone se comunica com duas estruturas: da Pagar.me e da Stone.
No Pagar.me, vocês como parceiros possuem uma merchant, e cada um dos seus clientes (estabelecimentos) são uma account, que por sua vez possui uma chave transacional, Secret_Key vinculada. Esta account está associada à um Stonecode, que é a identificação do estabelecimento na Stone. Dentro deste registro são vinculados os POS, as máquinas que serão usadas para transacionar.
No diagrama abaixo você consegue entender como cada participante está vinculado e suas nomenclaturas:
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.
curl --location --request POST https://api.pagar.me/core/v5/orders' \
-H 'Authorization: Basic c2tfdGVzdF9*Og==' \
-H 'Content-Type: application/json' \
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
NÃO COMPARTILHE SUAS CHAVES DE API
A sua chave da API é SECRETA e não deve ser compartilhada com terceiros.