---
updatedAt: 2026-08-10T19:53:10.000Z
---

Fetch the complete documentation index at: https://docs.pagaleve.com.br/llms.txt. Use this file to discover all available pages before exploring further.

# Teste seu checkout Wake

Valide a integração Pagaleve na Wake Commerce e resolva problemas comuns de checkout, scripts e marketplace.

Valide Pix à vista e Parcelamento no Pix no checkout Wake antes de considerar a integração concluída.

## Como testar

Depois de concluir a [configuração do método de pagamento](./wake-02-configuracao-metodo-pagamento.md), siga estas etapas:

1. Acesse a loja pelo painel administrativo. Abra o link da loja a partir do admin, em vez de acessar o domínio diretamente, para garantir que você está no ambiente correto.
2. Adicione um produto ao carrinho pela busca, usando o código do produto. Isso evita problemas de seleção de cor ou tamanho na página do produto que podem bloquear o teste.
3. Finalize o pedido e confirme que o modal Pagaleve aparece.
4. Repita o teste para **Pix à vista** e **Parcelamento no Pix**.

<Callout icon="⚪" theme="info">
  ### Aguarde cerca de 5 minutos após liberar as URLs na etapa 6 da configuração antes de testar o checkout.
</Callout>

## Troubleshooting

| Sintoma                                                                                                                            | Causa provável e ação                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Modal Pagaleve não aparece no checkout                                                                                             | O nome do grupo está diferente do nome de exibição no gerenciamento de pagamentos. Padronize os dois valores.                                                                                                                                                                                                                                                          |
| O modal aparece, mas a seleção do método (Pix ou Parcelamento) não fica marcada visualmente                                        | Em geral, uma customização de CSS do tema da loja está sobrepondo o indicador visual; não é o script Pagaleve. Verifique com a agência ou o time responsável pelo front-end da loja.                                                                                                                                                                                   |
| O banner Pagaleve não aparece após selecionar o método, mesmo com a seleção visual corrigida                                       | Elementos do front-end estão sobrepondo o conector. Acione o time responsável pelo front-end da loja.                                                                                                                                                                                                                                                                  |
| Dois SDKs Pagaleve carregam na mesma página: `checkout.wake.pagaleve.js` e `checkout.wake-v2.pagaleve.js`                          | A loja usa Storefront 2.0 e a Wake já injeta o script automaticamente. O script manual do Gestor de Scripts pode estar duplicando o carregamento. **Não remova o script manual sem testar com cuidado**, pois isso pode impedir o modal de aparecer. Valide o comportamento, de preferência com acompanhamento do suporte Wake, antes de remover o script em produção. |
| Erro `404` em `cms-entries.pagaleve.com.br/payment-layout/<dominio>.json` no console                                               | Comportamento esperado. Esse endpoint personaliza o banner por loja; lojas sem banner customizado retornam `404`, sem interromper o fluxo.                                                                                                                                                                                                                             |
| O script parece correto no admin, mas uma versão diferente é carregada no console, como uma versão sem `-v2`, ou há tags aninhadas | O editor da Wake pode desformatar o script ao salvar. Reabra o script e compare o conteúdo linha a linha antes de publicar.                                                                                                                                                                                                                                            |
| O script carrega apenas no checkout, não na página de confirmação ou finalização                                                   | Comportamento conhecido em lojas Storefront 2.0, que depende da rota `confirmation` do conector. Reporte esse cenário ao time Pagaleve.                                                                                                                                                                                                                                |
| Erro HTTP `400` na criação do pedido citando `order.recipients[0].role`                                                            | A loja é marketplace e tem split habilitado na Wake, sem a configuração correspondente habilitada na Pagaleve. Acione o time Pagaleve.                                                                                                                                                                                                                                 |
| A venda de uma loja ou CD específico aparece na conta principal, em vez da conta correta                                           | A chave de API Pagaleve vinculada ao CD está incorreta. Confirme as credenciais de cada CD com o time Pagaleve.                                                                                                                                                                                                                                                        |
| Não é possível selecionar cor ou tamanho do produto, bloqueando o teste                                                            | Os atributos de produto da loja estão malformados. Adicione o produto pela busca, usando o código do produto, em vez de acessar a página do produto.                                                                                                                                                                                                                   |
| Há um erro genérico no checkout, inclusive ao selecionar cartão de crédito                                                         | Normalmente, há um erro no front-end da loja e não no conector Pagaleve. Investigue com a agência responsável pelo tema.                                                                                                                                                                                                                                               |

## Reconfigure o conector se o problema persistir

Se o modal continuar sem aparecer após verificar nomenclatura, escopo, credenciais e cache, apague as configurações do conector na Wake e configure novamente do zero. Repita as etapas 2 a 7 da [página de configuração](./wake-02-configuracao-metodo-pagamento.md).

Essa ação remove vínculos ou configurações corrompidas por uma tentativa anterior.

## Precisa de ajuda?

Entre em contato com o time Pagaleve pelos canais de suporte habituais e informe:

* URL da loja;
* ambiente: sandbox ou produção;
* forma de pagamento testada: Pix à vista ou Parcelamento no Pix;
* print do console do navegador durante o teste, se disponível.