Estou integrado na API Pagar.me V5 - Como migrar para o HUB?

    Já está integrado na V5 e precisa integrar no HUB? Veja os ajustes necessários.

     

    Tecnicamente, o Hub Pagar.me funcionará como um proxy para a API Pagar.me fazendo autorização a nível de aplicativos. Logo, todos recursos HTTP disponíveis na API Pagar.me estão disponíveis no Hub Pagar.me. Confira abaixo as etapas básicas para ajusta sua integração V5 para o HUB:
     

    1) Criar e configurar o aplicativo

    Para desenvolver um APP no Hub, a primeira etapa é criar um APP e configurá-lo em nossa plataforma de desenvolvimento. Peça ao seu BizDev (gerente comercial) acesso ao ambiente de desenvolvimento, assim como a documentação técnica.
     

    2) Implementar o Botão de Instalação na plataforma.

    O botão de instalação leva o usuário a visitar o site que configurou no app para instalar. Assim,  ele vai até o serviço do APP para iniciar o fluxo de instalação.

    Site parceiro de exemplo.

     

    Acesse o Repositório do Script para ver o código.


    3) Ajustar a URL Base

    • API V5 Pagar.me: https://api.pagar.me/core/v5/
    • API Hub Pagar.me: https://hubapi.pagar.me/core/v1/

    Exemplo: buscar um pedido de um determinado cliente:

    GET https://hubapi.pagar.me/core/v1/orders/{order_id}

     

    4) Autenticação

    Ao invés de utilizar a SecretKey (sk_xxxxx) é utilizado o AccessToken. É necessário autenticar a requisição usando Basic Authentication passando o AccessToken da instalação criptografado em Base64 no header Authorization como mostrado no exemplo abaixo:

    Headers 
    Authorization : Basic ODc5ZDAyMzU4OGJhYmE3YTgyZGE1ODkwOWExYjY2MmU0ZTU1YWE2MzQ1YzY4ZjA5MDZhYmU1ZjYwMGI2ODBhYg== 
    
    GET https://hubapi.pagar.me/core/v1/orders/{order_id}

     

    Lembrando que o AccessToken é obtido dentro do fluxo automático de instalação. 

     

    5) Permissões


    As permissões são todas as possíveis Ações e Eventos que seu APP pode precisar receber ou fazer na API do Pagar.me. Elas são divididas em “obrigatórias” e “opcionais” e serão exibidas no momento da instalação do seu APP. Assim, o lojista terá ciência das permissões que ele está concedendo para o APP e configurar as permissões que não são obrigatórias.

    Ações

    São ações ou requisições que o APP, em nome de uma loja, poderá fazer na API do Pagar.me a partir de um estímulo qualquer. São todos os recursos da API (method + endpoint), por exemplo: 

     

    Eventos

    São os webhooks ou notificações que a API envia após uma ação ter acontecido, seja executada pelo APP ou não. 

    Exemplo: Pedido Criado (order.created) e Pedido Pago (order.paid).

     

    6) Testes e Homologação

    Realize os testes e solicite a homologação do APP e da nova integração ao time de Suporte Parceiras.

    Conseguimos te ajudar?