Como Integrar com o PagSeguroV2

Nesta documentação estaremos demonstrando como realizar a ativação do pagseguro como gateway de pagamento em sua loja

Atualizado há mais de uma semana

Para iniciar, acesse o menu Configurações > Pagamentos > Gateways.

Clique na imagem para ampliar.

Na tela seguinte será exibida uma listagem com diversos gateways disponíveis.

Escolha a opção PagSeguro V2.

01. Gateway

Nesta página teremos as seguintes informações disponíveis.

  • Nome do Gateway: Nome do gateway utilizado

  • Identificador: Identificador único do gateway

  • Permite Análise de Risco: Podendo ser Sim ou Não, variando de acordo com a usabilidade de um serviço de análise de risco externo, como ClearSale por exemplo.

02. Configurações


Configurações de Ambiente

Nesta tela, selecione o ambiente Produção e clique em Conectar. Você será direcionado para o ambiente do PagSeguro onde deve realizar o login da sua conta.

Após realizar o login, a informação será alterada para Conectado.

Clique na imagem para ampliar.

Clique na Imagem para ampliar.

Clique na imagem para ampliar.

Configurações de Autenticação

Após realizar o login na etapa anterior, na área de autenticação será exibida algumas informações como Código de Autorização e ID de Conta do PagSeguro. Em Tipo de Autorização, use a opção Autorize e Capture como padrão. Apenas utilize a opção Somente Autorize caso utilize um sistema de análise de risco externo.

Configurações do Pix

Nesta opção, ajuste o tempo limite de validade do QR Code gerado ao fim do pedido para pagamento. Após este tempo excedido, o pedido de pix será cancelado automaticamente.

Clique na imagem para ampliar.

Configurações de Status

Aqui poderemos mapear diferentes mapas de status, de acordo com a forma de pagamento utilizada. Sendo assim, estará disponível um Mapa de Status padrão (utilizado para pagamentos via cartão), um mapa de status para boleto bancário e outro mapa de status para pagamentos PIX. Isso se dá devido a integração oferecer possibilidade de utilizar um analise de risco externo.

Como padrão, configure os mapas de status conforme as imagens abaixo:

Clique na imagem para ampliar.

Clique na imagem para ampliar.

Clique na imagem para ampliar.

Configurações para falhas no pagamento

Nesta configuração, adicione o status Cancelado Pagamento para que o pedido seja cancelado automaticamente em caso de falha de pagamentos.

Testando a Integração:

Após realizar estas configurações, altere na forma de pagamento para que o gateway PagseguroV2 e realize um pedido teste de boleto e outro de cartão para verificar se as informações estão corretas. Para validar se o pedido foi para o gateway, acesse o detalhe do mesmo e verifique o bloco de Transação do Pagamento e veja se foi gerado um ID de Transação conforme imagem abaixo.

Clique na imagem para ampliar.


Se encontrar qualquer dificuldade ou tiver perguntas, estamos aqui para ajudar! Clique aqui para acessar nosso canal de suporte.

Nossas equipes estão prontas para atendê-lo através dos diversos canais de atendimento disponíveis.

Seu feedback é extremamente importante para nós!

Por gentileza, tire um momento para avaliar a documentação que acabou de ler. Suas opiniões são cruciais para aprimorarmos nossa plataforma e proporcionar a melhor experiência possível.

Clique no quadro abaixo para deixar sua avaliação.

Respondeu à sua pergunta?