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
- No painel da sua loja, vá em Pagamentos > Serviços, clique em Ajustes e, na linha da Stone, em Configurar.
- Na seção Conexão, clique em Conectar na linha Credencial 1.
- Você será redirecionado para o ambiente seguro da Stone. Faça login com as suas credenciais.
- Se tiver mais de uma configuração, selecione a loja correta (a conta de Produção).
- 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:
- Vá em Pagamentos > Serviços e clique em Adicionar.
- 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)
- Vá em Pagamentos > Parcelas / Condições e clique em Adicionar.
- 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.
- Acesse a Dashboard da Stone: https://dash.pagar.me/
- Vá em Configurações > Conta.
- Localize o campo Domínios que poderão enviar requisições pelo checkout transparente.
- Adicione o domínio da sua loja sem o
https://: - Loja em domínio temporário Braavo:sualoja.braavo.com.br(geralmente semwww). - Loja em domínio oficial:www.sualoja.com.br(geralmente comwww). - Pressione Enter. O domínio deve aparecer listado.
- 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.