Como configurar a Stone na sua Loja Virtual

A Stone é uma das maiores empresas de pagamentos do Brasil. Com a nossa integração, que utiliza a plataforma Pagar.me da Stone, você aceita Pix, boleto e cartão de crédito (com parcelamento) e o cliente paga sem sair da sua loja.

O que você precisa

• Uma conta ativa na Stone / Pagar.me. Se ainda não tem, crie a sua pelo Pagar.me ou pelo portal de parceiros da Stone.
• Uma loja Jumpseller com País e Moeda principal configurados como Brasil e Real (BRL): acesse Painel de Administração > Geral > Opções.
• Os dados do cliente exigidos pela Stone no checkout: CPF ou CNPJ e telefone (para Pix), e também o endereço de cobrança completo (para boleto e cartão).

1. Obtenha as suas chaves na Stone (Pagar.me)

1. Entre no painel da Stone (Pagar.me) em id.pagar.me, abra a área Desenvolvimento e clique em Chaves.
2. Copie a Chave secreta (começa com sk_).
3. Copie a Chave pública (começa com pk_). Ela só é necessária se você quiser aceitar cartão de crédito.

Dica para testes: o Pagar.me fornece chaves de teste (sk_test_... e pk_test_...) que simulam pagamentos sem cobrar ninguém. As chaves de produção (sk_... e pk_...) são enviadas pela Stone depois da assinatura do contrato. Quando estiver tudo certo, troque as chaves de teste pelas de produção.

2. Adicione a Stone como método de pagamento

1. Acesse Painel de Administração > Checkout > Pagamentos, clique em Adicionar método e escolha Stone:

   
2. Preencha os campos:
   • Chave secreta: obrigatória.
   • Chave pública: obrigatória se o cartão de crédito estiver ativado.
   • Pix, Boleto e Cartão de crédito: escolha quais opções os seus clientes poderão usar. Pelo menos uma deve estar ativada.
   • Máximo de parcelas (sem juros): de 1 a 12. O valor do pedido é dividido em parcelas iguais, sem juros.

3. Salve as alterações.

   

Ao salvar, verificamos a chave secreta com a Stone. Se ela for recusada, o método de pagamento é desativado automaticamente e você verá um aviso: confirme se copiou a chave completa e se ela pertence à conta correta.

3. Configure o webhook

O webhook avisa a Jumpseller quando um pagamento é confirmado, por exemplo quando o cliente paga um Pix ou um boleto depois de fechar o pedido.

1. Depois de salvar, abra novamente o método Stone em Checkout > Pagamentos e copie a URL do webhook (botão Copiar):

   
2. No painel da Stone (Pagar.me), acesse Configurações > Webhooks e crie um novo webhook com essa URL.
3. Selecione os eventos de pedidos e de cobranças e salve.

O webhook é configurado uma única vez por conta Stone e vale para toda a sua loja.

Como o seu cliente paga

Na tela de pagamento, a Stone aparece como uma única opção com abas para cada forma de pagamento ativada:

• Pix: o QR Code e o código “copia e cola” aparecem na página do pedido e expiram em 1 hora. O pedido é marcado como pago assim que o pagamento é confirmado.
• Boleto: o código de barras e o link do boleto aparecem na página do pedido, com vencimento em 3 dias.
• Cartão de crédito: o cliente informa os dados do cartão, o nome impresso e escolhe o número de parcelas. Os dados do cartão são processados diretamente pela Stone no navegador do cliente e nunca passam pelos servidores da Jumpseller. Se o cartão for recusado, o cliente pode tentar novamente ou escolher outra forma de pagamento.

Dúvidas frequentes

A Stone não aparece no checkout. Confirme que o país e a moeda da loja são Brasil e BRL, que o método está ativado em Checkout > Pagamentos e que pelo menos uma forma de pagamento (Pix, boleto ou cartão) está marcada. A opção de cartão só aparece depois de salvar a Chave pública.

O Pix ou o boleto não é gerado. A Stone exige CPF ou CNPJ e telefone do cliente para o Pix, e também o endereço completo (rua, CEP, cidade e estado) para o boleto e o cartão. Verifique se o formulário de checkout da sua loja pede esses dados.

O pedido continua pendente depois de pago. Confirme que o webhook foi criado no painel da Stone com a URL correta. Enquanto isso, o status do pedido também é atualizado quando o cliente volta para a loja.

---

Se tiver mais perguntas sobre a integração, fique à vontade para nos escrever. Estamos aqui para ajudar!