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:

    1. 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.

     

    Site parceiro de exemplo.

     

    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

    Headers
    "PublicAppKey" : "e172302a-a9b8-4a34-a36d-e1d6ec10f59d"
    
    POST https://hubapi.pagar.me/auth/apps/access-tokens
    {
        "code": "879d023588baba7a82da58909a1b662e4e55aa6345c68f0906abe5f600b680ab"
    }
    

    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.

    Conseguimos te ajudar?