Gerando seu token de acesso

Para enviar as solicitações para a API, algumas informações são necessárias:

1. ClientApplicationKey : Chave pública da aplicação gerada pela Stone. O ClientApplicationKey deve ser enviado no cabeçalho da solicitação na chave Authorization

2. ClientEncryptionString: Chave aleatória que será gerada pela aplicação cliente. A ClientEncryptionString deve ser enviada no cabeçalho da solicitação na chave X-Authorization-Raw-Data

3. Signature: Chave ClientEncryptionString cifrada utilizando a SecretKey fornecida juntamente com a chave pública (ClientApplicationKey) gerada pela Stone. A Signature deve ser enviada no cabeçalho da solicitação na chave X-Authorization-Encrypted-Data

📘

HMAC SHA-512

A Signature é um HMAC gerado com algoritmo SHA-512. Deve-se utilizar como String de codificação o ClientEncryptionString juntamente do SecretKey gerado pela Stone.

É possível encontrar diversas plataformas web que geram a conversão HMAC com o algoritimo SHA-512, como, por exemplo, o Freeformatter.

4. Data de referência: Dia para o qual você deseja solicitar o arquivo. (Formato yyyyMMdd). A data de referência deve ser usada para completar a URL do endpoint

5. Código de afiliação Stone: Stone Code do cliente. O Stone Code deve ser usado como parâmetro para completar a URL do endpoint

👍

Enpoint

https://conciliation.stone.com.br/v1/merchant/{affiliationCode}/conciliation-file/{referenceDate}

EXEMPLO

Segue um exemplo utilizando credenciais inválidas. Após solicitada sua credencial para nossa API de Conciliação V2.2, encaminharemos duas chaves:

Com essas duas informações em mãos, temos:

❗️

ClientEncryptionString

Esta chave é de livre escolha do integrador, mas lembre-se que esta chave será utilizada para gerar a Signature.

Neste momento, precisamos gerar a chave Signature. Com os seguintes dados:

Para gerar a Signature, precisamos aplicar o algoritmo SHA512 no conteúdo da chave ClientEncryptionString utilizando a chave secreta SecretKey.

Podemos realizar este processo utilizando bibliotecas, algoritmos específicos ou mesmo por plataformas como: Freeformatter.

O resultado do processo com os dados do exemplo é:

Dessa forma, temos todos os dados necessários para montar o request:

A URI do request fica desta forma: https://conciliation.stone.com.br/v1/merchant/123456987/conciliation-file/20181112

O Header do request fica desta forma:

Authorization: Bearer 21e6a65b-234d-43e4-21r7-6c767890d2qt
x-authorization-raw-data: String-XPTO
x-authorization-encrypted-data: 4b74dc82fc7589e6aafda8fcca1f061b7aee48b48013fd52bb7e8e68bf895504d4544a5d02508f8408a645e8fd8da57582580925be4a353db8e312d87f3897f0