Fluxo de Integração

A PagFast busca simplificar e agilizar os processos de integração. Focamos em uma API REST rápida e segura, com comunicação realizada via protocolo HTTPS, garantindo um acesso seguro e de alta performance à sua operação.


Os Ambientes de Integração

Sugerimos fortemente a integração em nosso ambiente de Sandbox, e em seguida, o chaveamento de URL e chaves de acesso para o ambiente de Produção. Isso deve ser suficiente para o pleno funcionamento do seu sistema integrado.

Ambiente de Testes Sandbox

Você deve conseguir as credenciais de sua empresa junto com a equipe de tecnologia da PagFast. Algumas informações importantes sobre o Sandbox:

  • Painel Administrativo - Site para gerenciamento das contas e transações do Sandbox, onde você poderá gerar as suas credenciais de acesso para API.
  • Endereço da API REST do Sandbox: https://api.sandbox.pagfast.com/v1.
  • IP do servidor de notificações webhook (se necessário para whitelisting): 54.210.130.238 / 184.73.181.219
  • Link para nossa Coleção do Postman para Sandbox.

Ambiente de Produção

As transações realizadas no ambiente de Produção serão executadas em sua conta definitiva da PagFast, e utilizarão dinheiro real.

O time da PagFast deverá fornecer as configurações do ambiente de produção no privado, para ajudar a finalizar sua integração.


Temos o ambiente de Sandbox como referência inicial de implementação. Para integrar a PagFast, os seguintes passos devem ser seguidos.

A seguir, você terá acesso a um passo a passo completo para ajudá-lo a realizar a integração.


Criação de chave de acesso à API

Primeiro, você precisa criar uma chave de acesso à API. Para tal, siga os passos abaixo:

  1. Acesse o Painel Administrativo e observe que sua chave será criada para uma conta específica, visualizada na barra superior.

  1. Clique no menu Integração > Chave de acesso.

  1. Insira os dados de geração da chave de acesso e clique em Gerar Chaves.

  1. Visualize e armazene as informações de Chave e Segredo em local seguro, elas serão utilizadas na API de autenticação da PagFast.

A API Key gerada será criada com status Pendente e enviada para aprovação da PagFast. A chave gerada ficará inicialmente inativa para operação. Entre em contato com um membro da PagFast para aprová-la e ativá-la.


Obtendo um token de API

Todas as chamadas de API são protegidas por meio de um token de acesso Bearer que usa a especificação JWT (JSON Web Tokens). Essa tecnologia permite que o token seja verificado usando vários critérios de segurança, como: expiração, privilégios de acesso, verificação de integridade e assinatura do emissor.

O tempo de expiração padrão do token é de 60 minutos, o que pode ser verificado lendo o atributo exp do JWT. Na sua integração, agende a solicitação de um novo token antes que esta janela de expiração seja fechada.

Use sua Chave de acesso para obter o token de acesso conforme descrito na seção Autenticação da API.


🤝

Seus contatos técnicos para suporte


What’s Next