---
updatedAt: 2026-10-16T13:18:37.000Z
agentTools:
  projectIndex: https://docs.pagaleve.com.br/llms.txt
---

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

Configure o conector Pagaleve na Wake Commerce para habilitar Pix à vista e Parcelamento via Pix. 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 acessando a sua dashboard na 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.&#x20;

Ponto importante:<br />`Api-Key = Chave API Pagaleve`&#x20;

`Api-Token = Senha API Pagaleve`

## 2. Adicionar o(s) conector(es) Pagaleve

1. No painel Wake, acesse **Pagamentos → Conectores de Pagamento.**
2. Procure os conectores da Pagaleve
3. Temos 2 conectores: Pagaleve - Pix à vista e Pagaleve - Pix Parcelado
4. Clique no conector e selecionar adicionar conector

<br />

<Image src="https://files.readme.io/0ef810f18bedf48347ce67c43212bc88b38a63a947823da1522d5fa3f5a016cf-image.png" align="center" width="200px" />

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

<br />

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

## 2.1 Configure o(s) seu(s) conector(es)

1. Configurando o Pix à vista
   1. Nome da configuração: Pagaleve - Pix à vista
   2. Api-Key: chave de API Pagaleve (Coletada dentro da dashboard Pagaleve)
   3. Api-Token: senha API Pagaleve (Coletada dentro da dashboard Pagaleve)

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

1. Confiurando o Parcelamento via Pix
   1. Nome a configuração: Parcelamento via Pix
   2. Api-Key: chave de API Pagaleve (Coletada dentro da dashboard Pagaleve)
   3. Api-Token: senha API Pagaleve (Coletada dentro da dashboard Pagaleve)

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

## 3. Crie e vincule os grupos de pagamento

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

<br />

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

<br />

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

<br />

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

<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 `Pagaleve` nos dois campos e `Pagaleve` nos dois campos do segundo grupo. Nomes divergentes são a causa mais comum de o modal Pagaleve não aparecer no checkout.
</Callout>

<br />

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 **Pagaleve**.
6. Clique em **Vincular configurações** e selecione o conector Pagaleve.
7. Ambos os os conectores, Pagaleve devem ser vinculados com A vista.

<br />

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

<br />

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

<br />

<br />

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

<br />

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

## 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 (Opcional)

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. Configure o Gestor de Scripts

1. Acesse **Configurações → Gestor de Scripts**.
2. Clique em **Adicionar Script**.
3. Preencha os campos.
4. Salve o Script criado.

<Image src="https://files.readme.io/4df6270a461032517d4a12f312387d4acaf7c8e272d7122210d1215f436dabca-image.png" align="center" caption="Passo 1" />

<Image src="https://files.readme.io/25831cb1522b989a163282976ca64090ef83481c79ec8aef939e43c74c240786-image.png" align="center" caption="Passo 2" />

<Image src="https://files.readme.io/635131b4055aec0a2a8bc2f7639548cce54d03da72a6379718b9d29fe4d9f6da-image.png" align="center" caption="Passo 3" />

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

<br />

<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 = "Pagaleve- Pix à vista"; // Use o nome de exibição do grupo Pix à vista.
  var upfrontPaymentMethodName = "Parcelamento via Pix"; // 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 = "Pagaleve- Pix à vista"; // Use o nome de exibição do grupo Pix à vista.
  var upfrontPaymentMethodName = "Parcelamento via Pix"; // 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).