A integração com o PagBank (PagSeguro) permite processar pagamentos realizados na loja por meio de PIX, boleto e cartão de crédito.
Além da criação das transações, a integração possui recursos para consulta, captura e estorno de pagamentos.
A integração possui suporte aos seguintes meios de pagamento:
Importante: configurar o conector do PagBank não disponibiliza automaticamente esses meios de pagamento no checkout. Após configurar a integração, é necessário vincular o conector aos meios de pagamento que serão utilizados na loja.
A integração contempla:
Observação: algumas operações, como captura e estorno, podem depender das permissões disponíveis para o usuário.
Antes de configurar a integração, certifique-se de possuir uma conta ativa no PagBank e as credenciais necessárias para o ambiente que será utilizado.
A integração utiliza credenciais específicas do PagBank para realizar a comunicação entre as plataformas.
Para a configuração, podem ser utilizadas:
As credenciais de produção e homologação são diferentes. Por isso, utilize sempre as informações correspondentes ao ambiente configurado.
Importante: as credenciais são informações sensíveis e não devem ser compartilhadas ou expostas publicamente.
No painel administrativo da Uappi, acesse:
Configurações > Pagamento > Gerenciamento
Localize o conector correspondente à integração PagBank/PagSeguro via WAPI e acesse a opção de edição.
Atenção: caso existam outros conectores do PagSeguro no ambiente, localize o PagBank identificado pelo hash pagseguro-api antes de acessar a configuração.
Na tela de edição, preencha as informações necessárias para a integração.
Informe as credenciais correspondentes à conta PagBank utilizada pela loja.
Informe o token utilizado para autenticar as requisições realizadas entre a Uappi e o PagBank.
Informe a chave pública utilizada pelo PagBank para o processamento seguro dos dados de cartão de crédito no checkout.
Importante: utilize credenciais correspondentes ao mesmo ambiente. Credenciais de homologação não devem ser utilizadas em produção e vice-versa.
Quando disponível para o usuário, a configuração Homologação permite definir se a integração utilizará o ambiente de testes.
As opções são:
No ambiente de homologação, devem ser utilizadas as credenciais específicas do sandbox do PagBank.
Observação: a configuração de Homologação pode não estar disponível para todos os perfis de acesso. Caso o campo não seja exibido no seu ambiente, entre em contato com o Suporte da Uappi.
Para pagamentos com cartão de crédito, a integração possui configurações específicas relacionadas à captura da transação e à atualização do pedido.
A opção Captura automática define se a transação de cartão de crédito será capturada automaticamente após a autorização.
Quando habilitada, a transação é autorizada e capturada automaticamente.
Quando desabilitada, a transação permanece aguardando a captura posterior.
Importante: essa configuração se aplica ao cartão de crédito. Pagamentos realizados por PIX e boleto não utilizam esse fluxo de captura manual.
Define se o status do pedido na Uappi será atualizado após a captura da transação.
Define se o status do pedido será atualizado quando ocorrer o cancelamento da transação.
A integração também possui campos para configurar informações relacionadas à transação.
Define a descrição utilizada para identificar a compra na fatura do cartão do cliente.
O campo permite no máximo 13 caracteres.
Define a informação enviada como observação da transação.
Após salvar a configuração do conector, é necessário vinculá-lo aos meios de pagamento que serão disponibilizados no checkout.
Esse processo deve ser realizado individualmente para os meios que serão utilizados:
Acesse a configuração de cada meio de pagamento e selecione o conector correspondente ao PagBank/PagSeguro
Repita o processo para todos os meios de pagamento que deverão utilizar a integração.
Importante: apenas configurar e salvar o conector não é suficiente para disponibilizar o PagBank no checkout. O conector precisa estar vinculado aos meios de pagamento utilizados pela loja.
O callback da integração é realizado automaticamente pela Uappi.
A própria plataforma envia a URL necessária para o processamento das atualizações das transações.
Por isso, não é necessário cadastrar manualmente um webhook ou uma URL de callback no painel do PagBank.
Pedidos podem conter itens com valor R$ 0,00, como brindes e cortesias.
Ao processar o pagamento pelo PagBank, esses itens podem não aparecer nos dados enviados ao PagBank.
Esse é um comportamento esperado da integração e não exige nenhuma ação ou configuração adicional. O item permanece normalmente no pedido da Uappi.
Importante: caso um item com valor diferente de R$ 0,00 não seja enviado ao PagBank, entre em contato com o Suporte da Uappi para análise.
A integração possui suporte a PIX, boleto e cartão de crédito.
Não. Após configurar o conector, é necessário vinculá-lo individualmente aos meios de pagamento que serão utilizados na loja.
Não. O callback é tratado automaticamente pela integração, sem necessidade de cadastrar manualmente uma URL no PagBank.
Não. A configuração de captura automática se aplica às transações realizadas com cartão de crédito. PIX e boleto não utilizam o fluxo de captura manual.
Não. Os ambientes possuem credenciais específicas. Utilize o token e as demais credenciais correspondentes ao ambiente configurado.
Leave a Reply