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 crie sua Loja e seu Usuário em nosso Dash,
2 - Após acessar o Dash, navegue até a área de Configurações e resgate suas chaves.
Clientes integrados na versão anterior da API
Caso você já seja cliente Mundipagg e esteja integrado na versão anterior da API, entre em contato com o nosso time de migração através do email [email protected]
Endpoints para teste e produção
As chamadas de testes e de produção devem ser feitas para o mesmo endpoint: https://api.mundipagg.com/core/v1.
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 Chave Secreta de Sandbox:
sk_test_tra6ezsW3BtPPXQa
- Exemplo de Chave Pública de Sandbox:
pk_test_gaa5xzfz7CfPPZAv
Após o fechamento do contrato o cliente receberá as chaves do ambiente de produção:
- Exemplo de Chave Secreta de Produção:
sk_fbt5cahT3BbHAXZy
- Exemplo de Chave Pública de Produção:
pk_ghc3waxT4BaCZXAb
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.mundipagg.com/core/v1/orders',
headers: {
'Authorization': 'Basic ' + new Buffer("sk_test_tra6ezsW3BtPPXQa:").toString('base64'),
'Content-Type': 'application/json'
},
json : body
};
request(options, function(error, response, body) {
console.log(response.body);
});
Chave Pública de API (PK)
Essas chaves serão utilizadas para representar a sua loja na integração com o checkout transparente.
NÃO COMPARTILHE SUAS CHAVES DE API
A sua chave da API é SECRETA e não deve ser compartilhada com terceiros.
Autorização Bearer Token para Gerenciamento de Wallets
Para o gerenciamento de Wallets você deverá autenticar-se nos servidores da Mundipagg através de um Access Token, que é um token temporário que permitirá o gerenciamento de cartões, pedido, cobranças e muitos outros recursos, sem que dados sensíveis trafeguem em seus servidores. Saiba mais sobre Wallets.
Para se autenticar conosco através do Access Token você deve enviá-lo no cabeçalho Authorization, seguindo o padrão da HTTP Bearer Token.
var fs = require('fs');
const request = require("request");
var body = JSON.parse(fs.readFileSync('body_card.json', 'utf8'));
var access_token = '4wdOK29W6RvyYbgPv63VPMYopk4Jy752dqbQxmm3qOgKy8dbexRvXQaGDZE0AYws88s7z64lWJnM1P7Vk9jYL2No5wp89jg1leNnG0WwXZOKDaLER3MXq07jQLokJn5m'
var customer_id = 'cus_9El4qnTEKFKQoV7r'
console.log(body);
var options = {
method: 'POST',
uri: 'https://api.mundipagg.com/core/v1//customers/'+customer_id+'/cards',
headers: {
'Authorization': 'Bearer ' + access_token,
'Content-Type': 'application/json'
},
json : body
};
request(options, function(error, response, body) {
console.log(options.headers['Authorization']);
console.log(response.body);
});
Saiba mais informações sobre como criar e utilizar o Access Token