Como configurar a integração com o PagBank na Uappi?

O que é a integração com o PagBank?

O PagBank é um gateway de pagamento integrado à Uappi, permitindo o recebimento via Pix, boleto e cartão. A integração oferece funcionalidades como consulta, captura, transação e estorno para facilitar a gestão dos pagamentos.

Passo a Passo

1. Obtenha suas Credenciais do PagBank

Para configurar o PagBank na Uappi, você precisa criar uma conta e obter suas credenciais. Veja como:

• Acesse o site do PagBank e faça login com seu e-mail e senha.
• No painel administrativo, vá até a aba lateral “Tokens”.
• Clique em “Gerar Token” para criar um novo token ou, caso já tenha um gerado, copie o código existente.
• Caso precise de mais detalhes, consulte a documentação da API PagBank.

2. Configure o Gateway de Pagamento na Uappi

Após obter suas credenciais, siga os passos abaixo para configurar o PagBank na Uappi:

1. Acesse Configurações > Pagamento > Gerenciamento.
2. Selecione a opção de edição do PagBank.

Na tela de configuração, preencha os seguintes campos:

✅ Homologação: ativa o ambiente de testes para simular transações sem impacto real.
✅ Token de Autenticação: insira o token gerado no painel da PagBank.
✅ Captura Automática: define se a compra será validada e capturada automaticamente ou apenas validada, exigindo captura manual.
✅ Alterar status do pedido quando a transação for capturada: ajusta automaticamente o status do pedido ao capturar a transação.
✅ Alterar status do pedido quando a transação for cancelada: ajusta automaticamente o status do pedido em caso de cancelamento.
✅ Descrição na fatura do cartão: define como a compra aparecerá na fatura do cliente.
✅ Observação do pagamento: insira uma mensagem que será exibida no detalhe do pagamento.

Após preencher todos os campos, clique em “Salvar” para concluir a configuração.

Dicas Úteis

• Teste antes de ativar em produção! Utilize o ambiente de homologação para garantir que as transações ocorrem corretamente.
• Verifique se seu token está atualizado no painel da PagBank antes de ativar o gateway.
• Consulte o suporte do PagBank caso tenha dúvidas ao obter suas credenciais.
• Revise as informações preenchidas para evitar erros nas transações.

Dúvidas Comuns

• Preciso ter uma conta no PagBank para configurar o gateway na Uappi?
  Sim, é necessário criar uma conta e obter as credenciais diretamente no PagBank.
• O que acontece se a transação for cancelada?
  Se a opção “Alterar status do pedido quando a transação for cancelada” estiver ativada, o status do pedido será atualizado automaticamente na Uappi.
• Consigo testar pagamentos antes de ativar para os clientes?
  Sim! O ambiente de Homologação permite simular transações sem impactar pedidos reais.
• A captura automática é obrigatória?
  Não, você pode escolher entre captura automática ou manual ao configurar o gateway no painel da Uappi.

Precisa de mais ajuda?

Acesse nossa base de conhecimento na Central de Ajuda para mais conteúdos sobre a Uappi.