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.

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:
- Criar Pedido (POST /core/v5/orders)
- Listar Pedidos (GET /core/v5/orders).
- Lista de Ações: https://docs.pagar.me/docs/lista-de-actions
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).
- Lista de Eventos: https://docs.pagar.me/docs/lista-de-events
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.