---
updatedAt: 2026-08-11T11:50:15.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.

# Configuração do método de pagamento Pagaleve

Configure o conector Pagaleve na Wake Commerce para habilitar Pix à vista e Parcelamento no Pix.

Ative o conector Pagaleve para oferecer Pix à vista e Parcelamento no Pix em uma loja Wake Commerce.

## Pré-requisitos

Antes de começar:

* Acesse o painel administrativo Wake da loja que você quer configurar.
* Obtenha a chave de API e a senha ou token de acesso com o time Pagaleve.
* Confirme com o time Pagaleve se a loja opera como **marketplace** (múltiplas lojas ou CDs no mesmo portal Wake). Essa configuração inclui uma etapa adicional em [Lojas marketplace](#8-lojas-marketplace-múltiplos-cdslojas).

## 1. Confirme as credenciais Pagaleve

Use a `Api-Key` e o `Api-Token` fornecidos pelo time Pagaleve para autenticar a comunicação entre a Wake e o conector Pagaleve. Tenha os dois valores disponíveis antes de continuar.

## 2. Crie o conector de pagamento customizado

1. No painel Wake, acesse **Pagamentos → Conectores de Pagamento (F-Gateway)**.
2. Na opção **Custom**, clique em **Nova Configuração**.
3. Informe um nome para a configuração, como **Pagaleve**.
4. Selecione a forma de pagamento **Customizado** e clique em **Adicionar Configuração**.

A configuração será criada em branco. Preencha os campos abaixo e clique em **Atualizar**.

<Image src="https://files.readme.io/59358adf6d2bf080fe1bdfd33ba13a0509977cd89475acd46c1a42e34ac9484b-image.png" align="center" />

![](https://files.readme.io/8db4378ad479c88c305bd2f236213886846b4198c556fbda8db33c00f0a91af6-image.png)

| Campo                          | Valor                                                                       |
| ------------------------------ | --------------------------------------------------------------------------- |
| Nome da configuração           | Nome dado à forma de pagamento, como `Pagaleve`                             |
| URL — PIX Parcelado (sandbox)  | `https://sandbox-external-api.pagaleve.io/v1/wake/api/v1/wake-provider`     |
| URL — PIX Parcelado (produção) | `https://external-api.pagaleve.com.br/v1/wake/api/v1/wake-provider`         |
| URL — PIX à vista (sandbox)    | `https://sandbox-external-api.pagaleve.io/upfront`                          |
| URL — PIX à vista (produção)   | `https://external-api.pagaleve.com.br/v1/wake/api/v1/wake-provider/upfront` |
| Versão                         | **Completa**                                                                |
| Headers                        | `Api-Key` e `Api-Token`, com os valores recebidos do time Pagaleve          |
| Antifraude                     | **Nenhum**                                                                  |

## 3. Crie e vincule os grupos de pagamento

1. Em **Pagamentos**, acesse **Grupos e Parcelamentos**.
2. Clique em **Criar Grupos**.
3. Crie um grupo para Pix à vista e outro para Parcelamento no Pix.

<Image src="https://files.readme.io/b3586c2b3c20c8b9cf2265b72de4a29fe3c7b82bcfad445c2baa98af7e2d1c09-image.png" align="center" />

<Image src="https://files.readme.io/8a938db243575b96396ccbb8357a89ae5f60d9fe166e0d6bcb2540893bb4c345-image.png" align="center" />

<Image src="https://files.readme.io/147e4d6c74b66e09754b129d69616b79f1afef302229602e7cfc10dd3ad0213d-image.png" align="center" />

<br />

<Callout icon="⚠️" theme="warning">
  ### Crie dois grupos: um para Pix à vista e outro para Parcelamento no Pix. Em cada grupo, o **nome do grupo** e o **nome de exibição** devem ser idênticos. Por exemplo, use `Pix - paga leve` nos dois campos e `Parcelamento no Pix - paga leve` nos dois campos do segundo grupo. Nomes divergentes são a causa mais comum de o modal Pagaleve não aparecer no checkout.
</Callout>

Para cada grupo:

1. Informe o nome escolhido nos campos de nome do grupo e nome de exibição.
2. Deixe os valores mínimo e máximo como `0`.
3. Habilite **Validar limite de crédito**.
4. Salve o grupo.
5. Clique em **Vincular formas de pagamento** e selecione **Customizado**.
6. Clique em **Vincular configurações** e selecione o conector criado na etapa 2.

<Image src="https://files.readme.io/97d147882044145a16143a8a2d0c6a6627e91d9f8ac6f1fcbb2554d285dddf68-image.png" align="center" />

<Image src="https://files.readme.io/59986c017e4cd5215bc36d31f5c9f1c65c4eb1c24238fab26b3de7c97495d772-image.png" align="center" />

<Image src="https://files.readme.io/6d5ef0ff0853faa68c1f19442b0ada27f192599aa331eb261c4764053517b46b-image.png" align="center" />

<br />

## 4. Crie o parcelamento À vista

1. No canto superior direito da tela, acesse **Parcelamentos** e crie um novo parcelamento caso não exista. Use as informações da imagem abaixo como referência.
2. Em **Parcelamentos**, clique em **Criar parcelamento**.
3. Preencha os valores abaixo e salve.

![](https://files.readme.io/db1bd3d60ebe3db32feebaa8c75122bfa5e5dfa6acc0dfa4640d2db9fcbefa1a-image.png)

<br />

| Campo                    | Valor     |
| ------------------------ | --------- |
| Nome                     | `À vista` |
| Número de parcelas       | `1`       |
| Valor mínimo por parcela | `0`       |

Depois de criar o parcelamento:

1. Abra cada um dos dois grupos de pagamento.
2. Clique em **Vincular Parcelamento**.
3. Selecione o parcelamento **À vista**.
4. Habilite os dois grupos pelos toggles.

O vínculo é obrigatório nos dois grupos, inclusive no grupo de Parcelamento no Pix.

![](https://files.readme.io/f97cdf520da794f82f8d6de92638bb504cad8bc92bd9fc856507b312170a2870-image.png)

![](https://files.readme.io/8f5e278b81fd74e5f32da1059e804e10323f8863012c53d47d590d13e438a641-image.png)

<br />

## 5. Adicione os grupos à estrutura de pagamentos

1. Em **Pagamentos**, acesse **Estrutura de Pagamentos**.
2. Clique em **Selecionar grupo de pagamento**.
3. Adicione os dois grupos criados na etapa 3 à estrutura de pagamentos existente da loja.

![](https://files.readme.io/f07633436017e887692691dd6e20f3a3c4004448a519243adea2f2b6d699b3d0-image.png)

<br />

<Callout icon="⚪" theme="info">
  ### Um grupo só aparece na lista de seleção quando o respectivo toggle está habilitado.
</Callout>

## 6. Libere as URLs na política de segurança

1. Acesse **Configurações → Políticas de Segurança → URLs Permitidas**.
2. Clique em **Adicionar Nova URL**.
3. Cadastre cada domínio abaixo separadamente.

![](https://files.readme.io/5a373618b3a61fa12de4f4181a9df452846274c9b5aa2637f1acdcc84d09bf66-image.png)

<br />

Preencha as rotas abaixo para liberação refazendo o processo acima uma por vez:

```text
*.pagaleve.com.br
*.pagaleve.io
```

Aguarde cerca de 5 minutos para a propagação das permissões antes de testar o checkout.

## 7. Configure o Gestor de Scripts

1. Acesse **Configurações → Gestor de Scripts**.
2. Clique em **Adicionar Script**.
3. Preencha os campos da seguinte forma.

![](https://files.readme.io/2a99b5e5cc10a40f045e3ffef9ac9c31498219ed65f9d4ce2f4199ace0eb1212-image.png)

<Image src="https://files.readme.io/88ccaf200d890efa59dd898ec2ea95c51a6c375528a28e358146c60860d2b289-image.png" align="center" />

<br />

| Campo                   | Valor                                       |
| ----------------------- | ------------------------------------------- |
| Nome                    | `Pagaleve` ou outro nome de sua preferência |
| Script Ativo?           | Sim                                         |
| Prioridade              | `1`                                         |
| Posição                 | **Body — Última linha**                     |
| Página                  | Todas                                       |
| Identificador de página | `*`                                         |

Adicione o script correspondente ao ambiente da loja.

### Sandbox

```html
<script>
  var auth = "Token gerado no passo 1";
  var paymentMethodName = "Pix - paga leve"; // Use o nome de exibição do grupo Pix à vista.
  var upfrontPaymentMethodName = "Parcelamento no Pix - paga leve"; // Use o nome de exibição do grupo Parcelamento.
</script>
<script src="https://sandbox-provider-public-assets.pagaleve.io/wake/checkout.wake.pagaleve.js"></script>
```

### Produção

```html
<script>
  var merchantId = "merchantID Pagaleve";
  var paymentMethodName = "Pix - paga leve"; // Use o nome de exibição do grupo Pix à vista.
  var upfrontPaymentMethodName = "Parcelamento no Pix - paga leve"; // Use o nome de exibição do grupo Parcelamento.
</script>
<script src="https://provider-public-assets.pagaleve.com.br/wake/checkout.wake-v2.pagaleve.js"></script>
```

<Callout icon="⚠️" theme="warning">
  Depois de salvar, abra o script novamente e confira cada linha antes de publicar. O editor da Wake pode desformatar o conteúdo e aninhar uma tag `<script>` dentro da outra.
</Callout>

<Callout icon="⚪" theme="info">
  ### **Lojas em Storefront 2.0:** a Wake pode injetar automaticamente pela API o script `checkout.wake-v2.pagaleve.js`, mesmo quando o script manual está configurado. Isso pode carregar dois SDKs Pagaleve na mesma página. Consulte [Teste seu checkout Wake](./wake-03-teste-checkout.md) para identificar e tratar esse cenário.
</Callout>

## 8. Lojas marketplace (múltiplos CDs/lojas)

Se a loja usa a opção **Múltiplos pagamentos por split** em Gerenciamento de conectores, confirme com o time Pagaleve que o merchant está habilitado para split de pagamentos antes de testar.

Sem essa habilitação, a criação do pedido falha e o pedido permanece em **Aguardando Pagamento**, sem exibir o modal. Em grupos com múltiplos CDs ou lojas, vincule cada CD à chave de API Pagaleve da loja correspondente. Não use a chave da loja principal em todos os CDs, pois as vendas das lojas secundárias podem ser direcionadas à conta incorreta.

## Checklist de ativação

* [ ] Confirmei a chave de API e o token no painel Wake.
* [ ] Usei o mesmo nome para grupo e nome de exibição nos dois grupos de pagamento.
* [ ] Criei o parcelamento **À vista**, com uma parcela e valor mínimo `0`, e o vinculei aos dois grupos.
* [ ] Configurei o script com a nomenclatura correta, escopo `*` e posição **Body — Última linha**.
* [ ] Verifiquei se a loja usa Storefront 2.0 antes de manter ou remover o script manual.
* [ ] Liberei `*.pagaleve.com.br` e `*.pagaleve.io`.
* [ ] Testei o checkout para Pix à vista e Parcelamento no Pix.

Depois de concluir a configuração, siga para [Teste seu checkout Wake](./wake-03-teste-checkout.md).