Transforme sua loja VTEX com a melhor solução de pagamento do mercado

A instalação é feita diretamente pelo VTEX App Store ou através do Admin da sua loja. Você deve procurar pelo aplicativo de pagamento da PagBrasil e clicar em “Instalar”. Após a instalação, o conector aparecerá como uma opção disponível dentro das configurações de Pagamentos > Configurações > Afiliações de Gateway.

Para que a comunicação funcione, você precisará de duas chaves principais fornecidas pela PagBrasil: o App Key (identificador da sua conta) e o App Token (chave de segurança). Essas credenciais devem ser inseridas no formulário de configuração da Afiliação de Gateway dentro do Admin da VTEX para autenticar as chamadas de API.

No menu Pagamentos, acesse Configurações e vá na aba Afiliações de Gateway. Clique no botão “+” e selecione o conector da PagBrasil. Lá, você preencherá os campos de credenciais, selecionará se a liquidação será automática ou manual e definirá o ambiente (teste ou produção). Após salvar a afiliação, você deve configurar as Condições de Pagamento (como Pix ou Cartão) para que utilizem esta afiliação específica.

Sim. O plugin possui um campo de “Ambiente” ou “Modo de Teste” na sua configuração. Ao ativar essa opção e utilizar as credenciais de Sandbox fornecidas pela PagBrasil, você pode realizar transações fictícias para validar se o checkout está processando os dados corretamente e se os status estão sendo atualizados sem gerar cobranças reais.

O fluxo é automatizado. Quando um pagamento é aprovado no sistema da PagBrasil, ela envia um sinal para a VTEX. O conector interpreta esse sinal e atualiza o status do pedido no OMS (Order Management System) de “Aguardando Pagamento” para “Pagamento Aprovado” (ou “Carência para Cancelamento”, dependendo da configuração), permitindo que o fluxo logístico prossiga.

Geralmente, o plugin moderno da PagBrasil para VTEX já lida com a URL de retorno automaticamente. No entanto, é fundamental garantir que o Endpoint de Notificação esteja configurado no seu dashboard da PagBrasil, apontando para o endereço do conector na VTEX. Isso garante que, mesmo que o cliente feche a janela do navegador, a confirmação do pagamento chegue à sua loja.

Sim. Se o prazo de validade do pagamento expirar (como um Pix não pago ou boleto vencido), a PagBrasil envia um status de cancelamento/expiração. A VTEX, ao receber essa informação através do conector, altera o status do pedido para “Cancelado”, liberando automaticamente os itens reservados de volta para o estoque.

Na maioria dos casos, o plugin é compatível com o Smart Checkout da VTEX de forma nativa. Contudo, para oferecer uma experiência “transparente” (onde o cliente não sai da loja), é importante garantir que o CSS do checkout não esteja bloqueando elementos visuais do plugin e que as opções de pagamento estejam devidamente mapeadas no painel administrativo.

O tempo de expiração deve ser configurado na Condição de Pagamento dentro da VTEX e deve ser igual ou superior ao prazo de validade definido na PagBrasil. Se a VTEX cancelar o pedido em 30 minutos, mas o Pix na PagBrasil durar 1 hora, você pode ter um problema de “pagamento órfão”. O ideal é alinhar ambos os prazos para garantir a melhor experiência.