Como configurar o Conector Pago Express (Pix) no Admin

Este artigo tem como objetivo orientar o lojista na configuração do conector Pago Express para o processamento de pagamentos via Pix e via Boleto na sua loja Wake Commerce.

A Pago Express oferece uma solução ágil e segura para transações instantâneas e para pagamentos via boleto bancário. Abaixo, detalhamos o passo a passo para integrar esta solução ao seu ecossistema.

1. Pré-requisitos

Atenção: Este conector é compatível apenas com o Storefront 2.0. Certifique-se de que a sua loja utiliza esta versão antes de prosseguir.

Antes de iniciar a configuração no Admin da Wake, é necessário ter a parceria comercial firmada com a Pago Express.

Após a confirmação da parceria, o time da Pago Express enviará as credenciais necessárias para a integração. Certifique-se de ter em mãos as seguintes informações:

• Client ID
• Client Secret
• Permitir Múltiplas Transações por Split? Esta feature flag deve ser habilitada para lojas que operam com múltiplos Centros de Distribuição (CDs) e utilizam o rateio de pagamento (split) entre eles. A ativação depende da compatibilidade técnica do conector utilizado.
  Nota: Atualmente, o conector Pago Express não suporta esta funcionalidade.
• Tipo Pagamento: Deverá ser preenchido com a forma de pagamento configurada, ou seja, pix ou boleto.

Nota: Caso ainda não tenha essas chaves, entre em contato com o suporte ou o seu gestor de conta na Pago Express. O time deles pode auxiliar diretamente neste processo de obtenção das credenciais.

Importante: As credenciais (Client ID e Client Secret) são obtidas exclusivamente junto à Pago Express. A Wake não gera nem fornece essas chaves.

Importante: Pix e Boleto são configurados como duas configurações de conector independentes, cada uma com o seu próprio valor no campo Tipo Pagamento, e vinculadas a grupos de pagamento distintos no checkout. Se a loja for oferecer as duas formas de pagamento, repita os passos 2 e 3 para cada uma delas.

2. Configurar o Conector no Admin

Com as chaves em mãos, siga os passos abaixo para ativar o conector:

1. Acesse o Admin da sua loja.
2. No menu lateral, navegue até Configurações > Pagamentos > Conectores.
3. Na lista de conectores disponíveis, encontre o conector “Pago Express”.
4. Em seguida, clique no botão de “Instalar configuração”.

Preenchimento dos Campos

Na tela de configuração do conector, preencha os campos conforme as instruções abaixo:

• Client ID: Insira a chave client-id fornecida pela Pago Express.
• Client Secret: Insira a chave client-secret fornecida pela Pago Express.
• Tipo Pagamento: Informe a forma de pagamento desta configuração:
  • pix — para pagamentos via Pix;
  • boleto — para pagamentos via Boleto.

As chaves devem ser cadastradas na seção Headers da configuração, conforme o quadro abaixo:

Após preencher todos os dados, clique em Atualizar.

Nota: Para oferecer Pix e Boleto na mesma loja, crie uma configuração para cada forma de pagamento, alterando apenas o valor do campo Tipo Pagamento. As chaves client-id e client-secret são as mesmas nas duas configurações.

3. Criar o Grupo de Pagamento (Pix e/ou Boleto)

Após configurar o conector, é necessário criar um grupo de pagamento que aparecerá para o cliente final no checkout.

1.No Admin, navegue até Configurações > Pagamentos > Gerenciamento de Pagamento.

2.Clique no botão + Criar Grupos.

3.Preencha os dados como Nome do Grupo, o Nome de exibição e o ícone de pagamento que deseja que apareça no checkout (ex.: “Pix” ou “Boleto Bancário”).

4.Salve e ative o grupo que acabou de criar.

5.Dentro do grupo criado, clique em “Vincular configuração” e selecione a configuração Pago Express correspondente à forma de pagamento do grupo (Pix ou Boleto).

6.Por último, clique em “Vincular parcelamento”.

Importante: Pago Express não é compatível com PIX Parcelado.

Importante: Pagamentos via Boleto também não são parcelados — o boleto é gerado sempre em parcela única, no valor total do pedido.

Nota: Crie um grupo de pagamento separado para cada forma de pagamento. Não vincule as configurações de Pix e de Boleto ao mesmo grupo.

4. Validação

Após finalizar a configuração:

1.Aguarde alguns minutos para a propagação das configurações.

2.Realize uma compra teste na sua loja selecionando a opção Pix e/ou Boleto.

3.Pix: verifique se o QR Code é gerado corretamente e se o pedido é integrado no Admin.

4.Boleto: verifique se o boleto é gerado corretamente, com linha digitável e data de vencimento válidas, e se o pedido é integrado no Admin.

5.Confirme que o pedido tem o status atualizado após a confirmação do pagamento pela Pago Express.

Dúvidas ou Suporte?

Se encontrar dificuldades durante a configuração das chaves ou se o pagamento não processar corretamente, o time da Pago Express está disponível para apoiar durante todo o processo de setup.

Entre em contato através dos canais oficiais de suporte da Pago Express ou abra um chamado na Central de Atendimento da Wake.