Como configurar Stone/Pagar.me com checklist do lojista

Configurar Stone/Pagar.me fica mais tranquilo quando a loja segue uma ordem visível: escolher o site, abrir Pagamentos, concluir a etapa solicitada pelo provedor, salvar, atualizar o checkout e conferir a vitrine. Este guia cuida da visão do lojista. Para a configuração própria da conta, use Guia de Integração com a Stone (antiga Pagar.me) no Interago.

Para quem é

Lojista, operador ou pessoa do financeiro que precisa colocar Stone/Pagar.me no checkout sem perder a visão do que o cliente verá.

Função

Ativar Stone/Pagar.me no site selecionado, escolher as formas de pagamento oferecidas pela loja e deixar o checkout pronto para uma conferência segura.

Como chegar

Antes de começar

• Confirme que a conta Stone/Pagar.me está liberada para receber vendas.
• Combine com o financeiro quais formas ficarão disponíveis: cartão, PIX, boleto ou mais de uma.
• Tenha um produto publicado, estoque definido e frete disponível para o teste.
• Escolha um valor e uma pessoa responsável pelo pedido de teste.
• Se a conta mostrar uma opção de integração, siga o fluxo exibido pela própria tela. Se pedir uma configuração feita pelo provedor, consulte Guia de Integração com a Stone (antiga Pagar.me) no Interago.

Checklist de configuração

1. [ ] Abra Meus websites e selecione o site correto.
2. [ ] Entre em Extensões → Checkout → Pagamentos.
3. [ ] Abra Stone/Pagar.me. O nome pode aparecer como Stone ou Pagar.me, conforme a tela da conta.
4. [ ] Conclua a integração ou o preenchimento solicitado na tela, sem deixar campos obrigatórios pela metade.
5. [ ] Confira se o cartão está habilitado para o público da loja.
6. [ ] Revise o parcelamento: quantidade de parcelas, juros e valor mínimo precisam combinar com a regra comercial da loja.
7. [ ] Ative PIX ou boleto somente se a conta e a operação estiverem prontas para oferecer essas formas.
8. [ ] Confira o prazo de expiração do PIX e o vencimento do boleto, quando esses campos aparecerem.
9. [ ] Se a loja usa chaves manuais, cadastre o webhook (bloco abaixo) antes de anunciar PIX/boleto.
10. [ ] Salve com Salvar Stone (ou o botão de salvar mostrado na tela).
11. [ ] Abra Checkout → Atualizar e atualize a loja.
12. [ ] Acesse a vitrine como visitante e confirme que a forma aparece com nome claro.
13. [ ] Faça uma compra de teste conforme a rotina permitida pela conta e localize o pedido em Pedidos.

Webhook na configuração manual (PIX e boleto)

O bloco Webhook - confirmação de pagamento aparece quando você configura a Stone com chaves manuais (textarea Chaves da Stone: chave pública na 1ª linha, secreta na 2ª). Sem essa URL no painel Pagar.me, PIX e boleto podem ficar aguardando pagamento mesmo depois de pagos. A mesma URL vale para todas as lojas.

1. Em Pagamentos, abra Stone e use o fluxo de chaves manuais.

2. No bloco Webhook - confirmação de pagamento, aguarde a URL (pode mostrar Carregando… por um instante).

3. Clique em Copiar URL. A tela confirma URL do webhook copiada. (Se precisar, use o prompt Copie a URL do webhook:.)

4. No painel Pagar.me/Stone, abra Configurações → Webhooks e cadastre a URL.

5. Marque os três eventos: order.paid, order.payment_failed e order.canceled.

6. Volte ao Interago, clique em Salvar Stone e atualize o checkout.

Passo a passo com prints no Guia de Integração com a Stone. A Pagar.me descreve o recurso em O que são webhooks.

Se a loja usa conexão assistida (quando existir) e o bloco da URL não aparecer, o fluxo de webhook manual não se aplica da mesma forma: o bloco aparece quando você configura com chaves manuais.

O que observar no pedido de teste

• O nome do meio aparece de forma compreensível.
• O total, o frete e o parcelamento estão corretos.
• O pedido entra uma única vez.
• O status corresponde ao resultado mostrado pelo provedor.
• PIX e boleto permanecem pendentes quando ainda aguardam confirmação.
• PIX e boleto só saem de pendente depois do webhook cadastrado (com os três eventos) na conta Pagar.me.
• A equipe sabe quem acompanhará a confirmação.

Não altere o status apenas para encerrar o teste. Se o pagamento demorar, consulte Checklist: pedido não aparece ou pagamento não confirma.

Se Stone/Pagar.me não aparecer

1. Confirme o site selecionado em Meus websites.
2. Volte a Pagamentos e veja se a configuração foi salva.
3. Confira se pelo menos uma forma está ativa dentro do card.
4. Use Checkout → Atualizar depois da última alteração.
5. Abra a loja em janela anônima e refaça a conferência.
6. Se a opção continuar ausente, retorne ao Guia de Integração com a Stone (antiga Pagar.me) no Interago e registre a mensagem exibida antes de pedir ajuda.

Checklist impresso do lojista

• [ ] Site correto selecionado
• [ ] Conta Stone/Pagar.me pronta para operar
• [ ] Forma de pagamento escolhida
• [ ] Parcelamento revisado
• [ ] PIX e boleto avaliados, quando disponíveis
• [ ] Na configuração manual: URL copiada com Copiar URL e cadastrada em Configurações → Webhooks (order.paid, order.payment_failed, order.canceled)
• [ ] Configuração salva (Salvar Stone)
• [ ] Checkout atualizado
• [ ] Forma visível na loja
• [ ] Pedido de teste localizado
• [ ] Status conferido
• [ ] Resultado registrado para a equipe

Artigos relacionados

• Guia de Integração com a Stone (antiga Pagar.me) no Interago
• Documentação: Métodos de pagamento na loja (Rede, Pagar.me, Cielo)
• Como conferir se o PIX automático está ativo
• Como explicar boleto ao cliente quando disponível
• Como testar cartão e PIX depois de configurar