Obtendo as chaves | Como é o fluxo de instalação de um App?
Descubra como obter as chaves necessárias para instalar seu aplicativo e acompanhe passo a passo o seu fluxo de instalação.
Para transacionar via aplicativo do HUB é necessário obter as chaves ou credenciais dentro do fluxo automático.
Confira as etapas:
- O fluxo se inicia quando o usuário lojista, após realizar o login na plataforma, clica no botão Integrar com o Pagar.me geralmente implementado em telas como “Configurações” ou “Integrações”.
Acesse o Repositório do Script para ver o código do Botão.

2. Esse botão tem o ID do App Parceiro (publicAppKey) implementado que será utilizado para redirecionar a pagina do aplicativo no ambiente do HUB. Ao ser direcionado, o lojista precisar realizar o login no Pagar.me.


3. Após clicar em Autorizar o lojista é redirecionado por meio da Redirect URL, também implementado no botão, de volta para pagina de configuração da plataforma trazendo o Authorization Code temporário (expira 180 segundos).
Exemplo:
// Configuração do Botão
{
...
redirectUrl : “https://meu-app.com/redirect”
}
// Após clicar em Autorizar
https://meu-app.com/redirect?authorization_code=879d023588baba7a82da58909a1b662e4e55aa6345c68f0906abe5f600b680ab
4. Como ultima etapa o front end utiliza o authorization_code obtido via query string e envia a requisição para o back end da plataforma a qual vai se comunicar com a API do HUB utilizando a Public Key do App e o Authorization Code. Ao confirmar a instalação a API do HUB retorna o Access Token necessário para transacionar.

Request
Response
Status 201: created
{
"command":"Install",
"accessToken":"879d023588baba7a82da58909a1b662e4e55aa6345c68f0906abe5f600b680ab",
"accountId":"acc_XXXXXXXXXXXXXXXX",
"merchantId":"merch_XXXXXXXXXXXXXXXX",
"installId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"accountPublicKey":"pk_test_XXXXXXXXXXXXXX",
"type":"Sandbox",
"additionalData": {
"customStringField": "custom value",
"customIntegerField": 10,
"customBoolField": true,
},
"events": [
"OrderPaid",
"OrderPaymentFailed",
"OrderCanceled"
],
"actions": [
"OrderCreate",
"OrderGet",
"OrderList"
]
}
5. Após obter as chaves definitivas o back retorna ao front que a instalação foi concluída com sucesso.
