Suporte: seg. a sex., das 9h às 18h

Como configurar a Stone

Atualizado em 22/10/2026

Este guia mostra como integrar a Stone à sua loja, da conexão inicial até a autorização do domínio para cartão de crédito.

1. Pré-requisitos

  • Acesso à Dashboard da Stone: confirme que você tem acesso ao painel da Stone, que é onde ficam as configurações do lado dela (diferente do painel da sua loja).
  • Conta ativa e em Produção: a conta precisa estar ativa e em modo de Produção. Contas de teste não processam vendas reais. Se a ativação ainda estiver pendente, agilize com a Stone.

2. Conectar a loja com a Stone

  1. No painel da sua loja, vá em Pagamentos > Serviços, clique em Ajustes e, na linha da Stone, em Configurar.
  2. Na seção Conexão, clique em Conectar na linha Credencial 1.
  3. Você será redirecionado para o ambiente seguro da Stone. Faça login com as suas credenciais.
  4. Se tiver mais de uma configuração, selecione a loja correta (a conta de Produção).
  5. Revise e aceite os termos apresentados para autorizar a comunicação com a sua conta.

Ao concluir, você volta para a tela da Stone no painel da sua loja, com o aviso "Conta da Stone conectada." e o selo Conectada na linha da Credencial 1. Se a Stone não concluir a conexão, a tela avisa e pede para conectar de novo.

Atenção: conecte a Stone depois que a loja estiver no domínio oficial. A conexão cadastra na Stone o endereço que avisa a loja dos pagamentos, e esse endereço é o do domínio em uso naquele momento. Se a conta foi conectada ainda no domínio temporário (.braavo.com.br), a linha mostra o selo Domínio provisório: depois da migração, exclua o aplicativo no Hub da Stone e clique em Reconectar, senão os avisos de pagamento param de chegar.

A tela guarda até duas contas de produção, a Credencial 1 e a Credencial 2, além da Conta de testes. O campo Credencial em uso escolhe qual conta processa os novos pedidos, e os pedidos já feitos seguem com a conta em que foram pagos. Para trocar de conta sem parar as vendas, conecte a conta nova na Credencial 2 e troque a Credencial em uso.

3. Ajustes logo após a conexão

Ainda na tela da Stone, configure:

  • Usar a análise de risco da loja — ligue se a loja usa um serviço de análise de risco (ClearSale ou Konduto). Desligada, a própria Stone recebe os dados da sessão do cliente para a análise dela.
  • Capturar o pagamento automaticamente — ligado, o pagamento no cartão é efetivado na aprovação. Desligado, a captura é feita depois, no pedido ou pela análise de risco da loja, quando ela está ligada.
  • Vencimento do boleto e Validade do Pix — o prazo do boleto, em dias, e do QR Code do Pix, em horas. Em branco, vale 1.
  • Link de pagamento — os meios aceitos no link (boleto, Pix e cartão), o número de parcelas, as parcelas sem juros, os juros ao mês, o valor mínimo da parcela e a validade do link. Para continuar gerando links a partir de 15/10/2026, atualize primeiro os termos no Hub da Stone. Acesse https://hub.pagar.me, vá em Minhas Instalações > Editar a instalação e clique em Atualizar Configurações. Depois, volte a esta tela e ative a opção Usar o novo link de pagamento da Stone.
  • Usar o ambiente de testes — mantenha desligado para processar vendas reais.

Clique em Gravar ao final.

Atenção: a integração com a Stone foi atualizada para acompanhar a nova forma de criar links de pagamento. Se a sua loja usa o link de pagamento, faça dois passos antes de 15/10/2026: atualize os termos do aplicativo no Hub da Stone, como explicado acima, e depois ative a opção Usar o novo link de pagamento da Stone. A conexão da loja continua a mesma, e não é preciso clicar em Conectar outra vez.

4. Adicionar os serviços de pagamento

Para as opções aparecerem no checkout:

  1. Vá em Pagamentos > Serviços e clique em Adicionar.
  2. No campo Serviço, escolha o que vai oferecer (por exemplo, Crédito Stone, Pix Stone ou Boleto Stone), defina o Nome no checkout e, se quiser, a Descrição no checkout. Deixe o Status em Ativo e grave. Repita para cada serviço.

5. Configurar o parcelamento (Condições)

  1. Vá em Pagamentos > Parcelas / Condições e clique em Adicionar.
  2. Escolha Crédito Stone e marque as parcelas que o checkout oferece, com o Tipo, a Taxa ou desconto e o Valor mínimo de cada uma. Esse é o passo principal: sem condição de parcelamento, o cartão não sabe em quantas vezes cobrar.

6. Autorizar o domínio na Dashboard da Stone (essencial para cartão)

Para processar cartão de crédito via checkout transparente, o domínio da sua loja precisa estar autorizado na Stone. Este passo acontece fora do painel da sua loja, na Dashboard da Stone.

  1. Acesse a Dashboard da Stone: https://dash.pagar.me/
  2. Vá em Configurações > Conta.
  3. Localize o campo Domínios que poderão enviar requisições pelo checkout transparente.
  4. Adicione o domínio da sua loja sem o https://: - Loja em domínio temporário Braavo: sualoja.braavo.com.br (geralmente sem www). - Loja em domínio oficial: www.sualoja.com.br (geralmente com www).
  5. Pressione Enter. O domínio deve aparecer listado.
  6. Role a página e clique em Salvar alterações.

Atenção: se a loja saiu de um domínio temporário (.braavo) para um domínio oficial, lembre-se de atualizar o domínio também aqui na Stone. Caso contrário, o cartão de crédito para de funcionar.

Para conferir, saia e entre de novo em Configurações > Conta e confirme que o domínio foi salvo e que a conta selecionada é a de Produção.

7. Validar a integração

  • Pix ou Boleto: faça um pedido de teste. Se o QR Code (Pix) ou o código de barras (Boleto) for gerado, a comunicação básica está funcionando.
  • Cartão de crédito: confirme antes que o passo 6 foi concluído. Faça um pedido de teste com cartão. Se a página não avançar ao finalizar a compra, o motivo mais comum é a falta de autorização do domínio na Stone. Revise o passo 6.

Observações

  • A conexão correta é a do passo 2 (botão Conectar, redirecionamento e autorização). Instruções antigas que pedem para inserir chaves de API manualmente não se aplicam a esta integração.
  • Com a Stone ativa em Pagamentos > Serviços, a tela não grava a escolha de uma Credencial em uso que ainda não foi conectada. Conecte a conta antes de escolhê-la.
  • Conectar a Conta de testes liga o ambiente de testes e apaga as conexões de produção, que precisam ser refeitas depois. Em uma loja que já vende pela Stone, isso deixa a loja sem receber até a reconexão.
  • A atualização dos termos no Hub da Stone não troca a conexão da loja e não muda nenhuma outra configuração. Ela concede à sua loja a permissão para criar links de pagamento pela nova forma, e é isso que mantém os links funcionando a partir de 15/10/2026. Por isso, ative a opção Usar o novo link de pagamento da Stone só depois de atualizar os termos.
  • Para dúvidas sobre taxas, funcionalidades da Dashboard da Stone ou ativação da conta, fale com o suporte da Stone. Para dúvidas sobre as configurações dentro do painel da sua loja, fale com o nosso suporte.