Stone - Pagar.me
Receba pagamentos automáticos via Pix ou Cartão de Crédito com a integração Pagar.me
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:
Acesse dash.pagar.me -> Configurações -> Chaves.
Em Dados da API, copie a Chave pública (
pk_…).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.
Na tela da integração, copie a URL do webhook (basta clicar no campo para copiar).
No painel do Pagar.me, acesse Configurações -> Webhooks e crie um novo webhook.
Cole a URL copiada e marque os eventos de Pedidos e Cobranças.
Salve.
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.
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.