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

Como configurar a Stone

Atualizado em 21/09/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 > Ajustes > Stone.
  2. Clique no botão Conectar com 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 de ajustes da Stone no painel da sua loja. Se a conexão der certo, a plataforma indica que o token foi configurado.

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. Primeiro, atualize os termos do aplicativo no Hub da Stone, como explicado na seção 3. 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.

3. Ajustes logo após a conexão

Ainda em Pagamentos > Serviços > Ajustes > Stone, configure:

  • Análise de risco externa ou captura automática: defina se vai usar uma análise de risco externa (se contratada) ou capturar as transações automaticamente.
  • Prazos de Boleto e Pix: defina os prazos de validade dos boletos e dos códigos Pix gerados.
  • Link de pagamento: ajuste, se for usar essa funcionalidade. 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, no fim da seção de link de pagamento.
  • Modo Sandbox: mantenha desabilitado para processar vendas reais.

Clique em Gravar ao final.

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. Selecione os serviços que vai oferecer (por exemplo, Crédito Stone, Pix Stone, Boleto Stone).

5. Configurar o parcelamento (Condições)

  1. Vá em Pagamentos > Parcelas / Condições.
  2. Crie as regras de parcelamento, principalmente para o Crédito Stone: número máximo de parcelas, juros, valor mínimo por parcela.

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.
  • 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.