Etapa 2: Autenticar-se
Objetivo
- Garantir a segurança das trocas de dados.
I. Recuperar chaves
Clique em Outras ações , no
Back Office EC . A seguinte janela é exibida:

- No menu Configuração > Loja , selecionar sua loja e ir na aba Chaves de API REST.
Quadro das chaves de API REST :
Para cada uso existe uma chave para o modo TESTE e uma chave para o modo Production.
NÚMERO | NOME DAS CHAVES | Descrição |
---|---|---|
1 | Usuário | Para as chamadas aos Web Services REST |
2 | senha | Para chamadas aos Web Services REST e para verificar a autenticidade dos dados retornados no IPN |
3 | Chave pública. | Para montar um formulário de pagamento no navegador do cliente |
4 | Chave HMAC-SHA-256 | Para verificar a autenticidade dos dados enviados no retorno do formulário de pagamento no navegador |
Esta ação é realizada por um usuário habilitado a gerenciar as chaves e os algoritmos de assinatura. O acesso à aba Chaves da API REST requer a ativação de uma funcionalidade específica. Favor entrar em contato com
Mais informações: as chaves API REST.
II. Fase de autenticação
- Criar um string com o usuário e o senha separados por dois-pontos (:)
- o nome de usuário é o login da loja: N°1: usuário da tabela de chaves da API REST
- oSenha, par exemple, pour la boutique de testtestpassword_DEMOPRIVATEKEY23G4475zXZQ2UA5x7M:N° 2: mot de passe du tableau des clés d'API REST
Codifique o string obtido em base64
Adicione a sua solicitação o header “Authorization” contendo “Basic” seguido do string codificado em base64:
Authorization: Basic Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN
Por exemplo, para a linguagem PHP , o header Authorization será calculado da maneira seguinte:
$header = "Authorization: Basic " . base64_encode($username . ':' . $password);
Segue umexemplo de solicitação. Pode acessar o SDK de TESTE no Playground para testar sua integração.
A solicitação HTTP completa terá a aparência da imagem abaixo. Pode acessar o SDK de TESTE no Playground.
{ "value": "my testing value" }
III. Exemplo de código
Exemplos de código, em diferentes linguagens estão disponíveis no Github.
IV. Exemplo simplificado PHP
Na pasta sample
, o arquivo para essa etapa é config.php. É usado para definir chaves de autenticação.
Para maiores detalhes, Arquivo de exemplo: config.php.