> For the complete documentation index, see [llms.txt](https://ola.meajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ola.meajuda.cc/delivery-salao/integracoes/stone-pagar.me.md).

# Stone - Pagar.me

<figure><img src="https://parceiros.online.alloy.al/webflow/delivery/images/Logo-Pagar-me.svg" alt="Pagar.me" width="280"><figcaption></figcaption></figure>

## Como funciona

Ao ativar a integração com o Pagar.me, você poderá receber pagamentos via **Pix** e **Cartão de crédito** automáticos pela loja do delivery, utilizando a API oficial do Pagar.me.

As bandeiras aceitas no cartão de crédito são: Visa, Master, Amex, Elo, Diners e Hipercard.

## Antes de começar

Você precisa de uma conta no Pagar.me com as chaves de API em mãos. No painel do Pagar.me:

1. Acesse [dash.pagar.me](https://dash.pagar.me) -> **Configurações** -> **Chaves**.
2. Em **Dados da API**, copie a **Chave pública** (`pk_…`).
3. Em **Chaves da API**, clique em **Criar chave** para gerar a **Chave secreta** (`sk_…`) e copie-a — ela é exibida apenas uma vez.

## Como ativar a integração

Acesse o menu **Integrações -> Pagamento online - Pagar.me** e ative a integração. Preencha os campos:

* **Chave pública (pk\_…)** — copiada em Configurações -> Chaves, na seção Dados da API.
* **Chave secreta (sk\_…)** — gerada em Configurações -> Chaves -> Chaves da API.
* **Cartão de crédito** — ative para aceitar pagamentos com cartão no checkout online.
* **Pix** — ative para aceitar pagamentos via Pix no checkout online.

Clique em **Salvar**. As chaves são validadas na hora: se estiverem incorretas, a integração não é ativada e o aviso *"Chaves do Pagar.me inválidas, verifique os dados e tente novamente"* será exibido.

## Configurando o webhook

O webhook é o que avisa o sistema quando um pagamento é aprovado, recusado ou estornado. Sem ele, os pedidos não mudam de status automaticamente.

1. Na tela da integração, copie a **URL do webhook** (basta clicar no campo para copiar).
2. No painel do Pagar.me, acesse **Configurações** -> **Webhooks** e crie um novo webhook.
3. Cole a URL copiada e marque os eventos de **Pedidos** e **Cobranças**.
4. Salve.

{% hint style="info" %}
**Importante:**

* Não é possível utilizar duas integrações de pagamento online ao mesmo tempo. Se você já tiver outra ativa (Mercado Pago, por exemplo), será exibido o aviso *"É preciso desativar o outro método de pagamento online para ativar este"*.
* Ao ativar o **Pix** pelo Pagar.me, a forma de pagamento **Pix manual** é removida automaticamente da loja, para evitar cobrança duplicada.
* Ao desativar a integração, a chave secreta é apagada por segurança. Para reativar, será necessário informá-la novamente.
* Todo o controle dos pagamentos e repasses deve ser realizado pelo painel do Pagar.me.
  {% endhint %}

## Estorno de pagamentos

O estorno é feito pela tela de **Pedidos**, no próprio painel. O resultado pode ser:

* **Estornado** — o valor foi devolvido ao cliente e o pedido é cancelado.
* **Estorno em processamento** — o Pagar.me ainda está processando a devolução. Aguarde e verifique novamente mais tarde; o status é atualizado automaticamente.
* **Estorno não confirmado** — a operação não foi aprovada e o pagamento permanece como aprovado. Nesse caso, trate o estorno diretamente pelo painel do Pagar.me.