Wake
Visão geral da integração da Pagaleve com a Wake Commerce, incluindo o fluxo do conector de pagamento e as versões de checkout.
Entenda como a Pagaleve se conecta à Wake Commerce para disponibilizar Pix à vista e Parcelamento no Pix no checkout da sua loja.
A Wake Commerce é uma plataforma brasileira de e-commerce. A Pagaleve é integrada ao painel administrativo da Wake como um conector de pagamento customizado.
Fluxo de integração
- O cliente seleciona a Pagaleve como forma de pagamento no checkout.
- A Wake chama a rota
payment-detaildo conector Pagaleve. A rota retorna o HTML e o JavaScript que personalizam o modal exibido no checkout. - Depois que o cliente confirma o pagamento, a Wake cria o pedido pela rota
paymentdo conector. O conector usa aApi-Keye oApi-Tokencadastrados na configuração para autenticar a criação do checkout. - Na tela de confirmação, o conector já incluiu o
checkout_ide aredirect_urlno pedido pela rota de Postback. Esse retorno permite carregar o checkout transparente da Pagaleve na página de confirmação.
Rotas do conector (documentação Wake)
| Rota | Uso |
|---|---|
| Visão geral do conector de pagamentos | Visão geral do protocolo de integração de pagamentos da Wake. |
| payment-details | Primeiro passo do fluxo. Retorna o HTML e o JavaScript do modal de pagamento. |
| payment | Chamada quando o cliente finaliza a compra com a Pagaleve selecionada. |
| postback | Atualiza o pedido com checkout_id e redirect_url, além de tratar o status enviado pelo webhook. |
| confirmation | Retorna o HTML e os scripts carregados na página de confirmação. Consulte a observação sobre o Storefront 2.0. |
| chargeback | Recebe solicitações de reembolso ou estorno. |
Duas versões de checkout: v1 e v2 (Storefront 2.0)
A maioria das lojas Wake integradas à Pagaleve usa a versão clássica do checkout (v1). Nela, o lojista adiciona manualmente o script da Pagaleve em Configurações → Gestor de Scripts; o script permanece fixo até ser editado.
Lojas mais novas podem usar a versão atual do checkout, chamada pela Wake de v2 ou Storefront 2.0. Nessa versão, o carregamento deixa de ser estático: a Wake injeta dinamicamente as tags <script> retornadas pelo conector de pagamento, conforme a rota confirmation.
Não há, no painel Wake, uma forma confiável de identificar antecipadamente se uma loja usa v1 ou v2. Essa diferença normalmente aparece durante a configuração ou o teste do checkout. Um sintoma comum é o script da Pagaleve carregar duas vezes na mesma página; consulte a seção de troubleshooting na página de teste do checkout ou consulte o seu account dentro da Wake.
Próximos passos
- Configure o método de pagamento Pagaleve para ativar a integração passo a passo.
- Teste seu checkout Wake para validar a integração e consultar o troubleshooting.
Links úteis
Updated about 24 hours ago