> For the complete documentation index, see [llms.txt](https://ajuda.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.toplojas.com.br/formas-de-pagamento/configurando-formas-de-pagamento/pagar.me-hub.md).

# PagarMe (Integração App)

## Contato com a Pagar.me

Em caso de dúvidas, você pode conversar com a Pagar.me pelos Telefones abaixo:

{% hint style="info" %}
**(11) 3157-3121**

**(11) 3004-9709**
{% endhint %}

Ou encaminhando um e-mail para:

<relacionamento@pagar.me>

## Contratação da Pagar.me

Antes de começar a Utilizar a Pagar.me, é necessário criar um cadastro na Pagar.me:

{% embed url="<https://cadastro.pagar.me/boas-vindas-ao-pagarme>" %}

Após isto, **"aguarde"** o Pagar.me aprovar sua Conta.

## Conectando Conta Pagar.me com sua Loja

Antes de começar a configurar, precisamos conectar a **Conta Pagar.me** com a **Loja.**

Clique em "**Config -> Métodos de Pagamento**", em "**PagarMe (Integração App)**" clique em "**Ativar**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-0eefcef1f0ee94eb67c8d23937dc4ec475c2f4e7%2F2023-08-11_13h35_33.png?alt=media" alt=""><figcaption></figcaption></figure>

Será aberta a janela da Pagar.me para que você entre com seus dados de acesso:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-a23f848e16cc6f35a724f5e458287eb6b446cb45%2F2023-08-11_13h36_48.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Fique Seguro!**

Sua senha de acesso ao Pagar.me não é compartilhada com a Loja, este processo apenas irá autorizar o Toplojas a criar Pagamentos em sua conta Pagar.me.
{% endhint %}

Após entrar, será exibido um campo de "**Selecione uma Loja**".

Selecione a conta "**Pagar.me**" que você deseja integrar com a Loja:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-2189735e15ac79991dbd6db9b061e038aa724821%2F2023-08-11_13h44_21.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Atenção:**

Caso seja selecionado uma conta com o sufixo "**test**" os pagamentos serão realizados no **ambiente de teste** da Pagar.me e não serão pagamentos reais.

Por padrão, deve ser selecionado a conta que **NÃO TENHA** o sufixo "**test**".
{% endhint %}

Na janela seguinte, apenas clique em "**Autorizar**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-2cc7675b381f4a701b840491dede755b3e5161cd%2F2023-08-11_13h39_02.png?alt=media" alt=""><figcaption></figcaption></figure>

Você será redirecionado para a loja onde será exibido um alerta confirmando que a Conta Pagar.me foi conectada em sua Loja:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-51410ac7e232ba932430411810b2284b02521346%2F2023-08-11_13h39_45.png?alt=media" alt=""><figcaption></figcaption></figure>

**Pronto!** Agora sua conta Pagar.me está conecta em sua Loja.

Observe também, que neste janela, será exibido os dados da Conta que está conectada na Loja, e também se a Conexão entre o Pagar.me e o Toplojas estão normais:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-758109758b749852f9faa1ac1c7d59f475da5cc6%2F2023-08-11_13h43_37.png?alt=media" alt=""><figcaption></figcaption></figure>

## Configurando a Pagar.me na Loja

Agora que conectamos a conta Pagar.me com a Loja, precisamos **configurar** as **opções de pagamento** e parcelamento para que os clientes possam pagar via Pagar.me.

Nesta mesma janela, desça até as configurações.

O primeiro campo que precisamos configurar é "**Formas de Pagamento**", onde iremos selecionar as opções que serão exibidas ao cliente.

Selecione as opções desejas, ou selecione todas para que os clientes tenham mais opções:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-22c080512a658821b6159088697eb0bb4093f8a8%2F2023-01-27_17h53_07.png?alt=media" alt=""><figcaption></figcaption></figure>

No campo "**Qtd. Parcelas sem Juros**" selecione a quantidade de parcelas sem juros:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-3885804d9fef18e026f2e8c60a96d0f3981ae47c%2F2023-01-26_18h34_06.png?alt=media" alt=""><figcaption></figcaption></figure>

No campo "**Qtd. de Parcelas Máximas**" selecione a quantidade máxima que será disponibilizada aos clientes:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-ddae85467e9f46edc0248b8fa8272301f1f0e7e5%2F2023-01-26_18h34_28.png?alt=media" alt=""><figcaption></figcaption></figure>

No campo "**Valor mínimo por Parcela**" preencha o valor mínimo que cada parcela pode possuir:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-d759b38e2480f5aca2f21d48d757674fb91772cf%2F2023-01-27_17h53_19.png?alt=media" alt=""><figcaption></figcaption></figure>

No campo "**Taxa de Juros**" você pode personalizar a Taxa de Juros que será cobrada nas parcelas que não forem contempladas pelo sem Juros:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-0bf9bf3852fbd9ba71a3c90bb915165a8bdff3d7%2F2023-01-27_18h50_54.png?alt=media" alt=""><figcaption></figcaption></figure>

Agora que configuramos, clique em "**Salvar Configurações**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-dc8d06170c059eb8d275bd22c25a6707fb1ac4a2%2F2023-01-26_18h34_47.png?alt=media" alt=""><figcaption></figcaption></figure>

Será exibido um alerta indicando que as configurações foram aplicadas com sucesso:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-157313107252aaa457f81e6256530c43c8eaa0f8%2F2023-01-27_18h04_28.png?alt=media" alt=""><figcaption></figcaption></figure>

**Pronto!** Agora o **Pagar.me** já está disponível para os Clientes.

{% hint style="warning" %}
**Não Esqueça!**

Faça um pedido de teste, com um cartão real, para confirmar que sua conta Pagar.me está pronta para receber pagamentos e que as configurações estão corretas.
{% endhint %}

## Configurando Conta Pagar.me

Após integrar a Pagar.me em sua Loja, é necessário executar algumas configurações dentro do **painel da Pagar.me**.

Acesse o painel da Pagar.me:

{% embed url="<https://dash.pagar.me/>" %}

Clique em "**Configurações -> Conta**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-5aba5e901ee8514d94515f66876f8461650c8f65%2F2023-08-26_07h39_47.png?alt=media" alt=""><figcaption></figcaption></figure>

Na seção "**Conta**" clique em "**Editar**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-5a58ffc3fc7891ec6facd3f419e8d4239a911860%2F2023-08-26_07h40_54.png?alt=media" alt=""><figcaption></figcaption></figure>

No campo "**Domínios**" preencha o domínio do seu site:

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-47d3f6aab08c57d099afdf1a296587d5425a0a98%2F2023-08-26_07h41_24.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**ATENÇÃO:**

O campo "**Domínio**" deve conter apenas o "**seusite.com.br**", não deve conter outros dados.\
\
**Exemplo Permitido:**\
seusite.com.br

\
**Exemplo não Permitido:**\
<https://www.seusite.com.br\\>
<http://www.seusite.com.br\\>
<https://www.seusite.com.br/index.php\\>
[www.seusite.com.br](http://www.seusite.com.br)
{% endhint %}

Desça a página e preencha sua senha no campo "**Confirmar Alteração**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-0a823259887a78d77879a407ba44ccf7734c421c%2F2023-08-26_07h42_02.png?alt=media" alt=""><figcaption></figcaption></figure>

Clique em "**Salvar alteração**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-4839ae601a2410e1b8a552f5171690a400012684%2F2023-08-26_07h42_16.png?alt=media" alt=""><figcaption></figcaption></figure>

## Perguntas Frequentes

### Acesse o módulo "Config -> Métodos de Pagamento -> PagarMe" e está aparecendo "Sua Conta Pagar.me não está mais Conectada com sua Loja!"

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-29401e33e04b7d4f38b046de3e678bcb0a96e2aa%2F2023-08-11_13h48_52.png?alt=media" alt=""><figcaption></figcaption></figure>

Quando este aviso ocorre, indica que a Loja **não tem mais acesso** a sua conta Pagar.me.

Neste caso, é necessário "**Reconectar**" a conta Pagar.me.

Para isto, clique em "**Reconectar na Conta Pagar.me**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-84c036f8569624f709f12eb93d602bb34206d640%2F2023-08-11_13h50_17.png?alt=media" alt=""><figcaption></figcaption></figure>

### Não está aparecendo o parcelamento disponível durante a navegação na Loja

Isto ocorre quando ainda **não foi configurado uma Forma de Pagamento Padrão** na Loja.

Acesse o link abaixo para consultar o tutorial de configuração da Forma de Pagamento Padrão:

{% content-ref url="/pages/-M8qNcruB5y3o2xavubi" %}
[Configurar Forma de Pagamento Padrão](/formas-de-pagamento/configurando-forma-de-pagamento-principal.md)
{% endcontent-ref %}

### Desativei a Pagar.me da loja, e ao tentar reativar é exibido "Este App não pode ser instalado mais de uma vez por loja":

Isto ocorre quando a Pagar.me foi desativada dentro da Loja, mas ainda consta a instalação no painel da Pagar.me.

Acesse o Link abaixo:

{% embed url="<https://hub.pagar.me/apps/c178bf93-1b6c-499f-b9cb-16ce4cafc2a2>" %}

Clique no botão de configurações em "**Instalações**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-aebd8ceff39d7abae186951e0037d52ac2d28725%2F2023-08-11_13h54_32.png?alt=media" alt=""><figcaption></figcaption></figure>

Selecione "**Excluir**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-fc963dc5cf254c32b076ecf6b7cff334b4d40a5e%2F2023-08-11_13h54_43.png?alt=media" alt=""><figcaption></figcaption></figure>

Clique em "**Confirmar**":

<figure><img src="https://3873222052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8H19OxR4N0phXKpriO%2Fuploads%2Fgit-blob-2ddd4130837ad81760122ce7019c19a3f09d11a5%2F2023-08-11_13h54_52.png?alt=media" alt=""><figcaption></figcaption></figure>

**Pronto!** Agora você pode reativar a Pagar.me na Loja.
