Por que não vejo o item Stone no menu PDV?

O item aparece só para o administrador do grupo e só com as extensões PDV e Stone contratadas. Veja como contratar extensões.

Como configurar a maquininha Stone no PDV do VendaSimples

Q: A cobrança passou na maquininha, mas a situação não mudou. O que faço?

Abra a cobrança na aba Pagamentos e clique em Verificar na Stone. Se acontecer sempre, confira se a URL do webhook está cadastrada no dashboard da Pagar.me, em Configurações > Webhooks.

Q: Onde vejo os dados do cartão de uma venda do PDV?

Em PDV > Vendas, ao visualizar a venda, o pagamento pela Stone mostra a bandeira, o NSU e a autorização. Veja como consultar as vendas do PDV.

Passo a passo para configurar a maquininha Stone no VendaSimples: Stone Code e Secret Key, webhook da Pagar.me, maquininhas e cobranças.

Atualizado em 6 de novembro de 2026 9 min de leitura

Com a integração Stone, o PDV manda o valor da venda direto para a maquininha Stone, sem digitar, e o pagamento só entra na venda depois de aprovado. Na tela Stone você liga a conta Stone de cada empresa, cadastra as maquininhas e acompanha as cobranças enviadas para a maquininha.

Antes de começar

A tela Stone só aparece com as extensões PDV e Stone contratadas (veja como contratar extensões) e só para o usuário administrador do grupo. Quem não é administrador vê a mensagem Só o administrador do grupo acessa a área Stone. (veja usuário normal ou administrador). Tenha em mãos o Stone Code e a Secret Key da conta e o acesso ao dashboard da Pagar.me, onde você cadastra o webhook.

Abra a configuração
No menu, clique em PDV e depois em Stone. A tela tem as abas Pagamentos, Maquininhas e Configuração. Clique em Configuração.
Escolha a empresa
Cada empresa tem a sua conta Stone. Se o grupo tem mais de uma empresa com a extensão Stone, escolha a empresa no campo Empresa, no topo. Com uma empresa só, o campo não aparece.
Informe os dados da conta
Em Stone Code, digite o código da conta na Stone. Em Secret Key, digite a chave secreta da conta na Pagar.me. Marque Integração ativa: a empresa cobra na maquininha Stone pelo PDV.
Escolha o parcelamento
Em Parcelamento padrão, escolha Lojista (sem juros para o cliente) ou Emissor (com juros para o cliente). Se quiser o comprovante impresso na maquininha, marque Imprimir o comprovante na maquininha.
Salve a configuração
Clique em Salvar configuração. Aparece a mensagem Configuração salva com sucesso! e a etiqueta ao lado de Integração Stone passa para Ativa.
Cadastre o webhook na Pagar.me
Em URL do webhook, clique em Copiar. No dashboard da Pagar.me, em Configurações > Webhooks, cadastre essa URL. O webhook é o endereço que a Stone usa para avisar o VendaSimples de cada pagamento.
Cadastre a maquininha
Abra a aba Maquininhas e clique em Adicionar maquininha. Digite o Número de série (S/N), que está na etiqueta atrás da maquininha, e um Nome (ex.: Caixa 1). Deixe Ativa marcado e clique em Salvar.
Ligue a maquininha ao caixa
No programa do PDV, no computador do caixa, o menu Stone liga as formas de pagamento à vista e escolhe a maquininha daquele caixa. Depois disso, a coluna Caixa do PDV, na aba Maquininhas, mostra qual caixa usa cada maquininha.

Campos da configuração

Campo	Para que serve
Integração ativa	Liga ou desliga a cobrança na maquininha Stone para a empresa. Com ela marcada, o Stone Code é obrigatório, e a Secret Key também, se ainda não foi salva.
Stone Code	O código da conta da empresa na Stone.
Secret Key	A chave secreta da conta na Pagar.me. Depois de salva, ela nunca volta para a tela: o campo fica vazio, com a dica Já informada: deixe em branco para manter. Preencha só para trocar a chave.
Fluxo da maquininha	Fica travado em Pagamento direto: a forma de pagamento escolhida no caixa vai junto para a maquininha, que só confirma.
Parcelamento padrão	Diz quem paga os juros do crédito parcelado: Lojista (a loja; sem juros para o cliente) ou Emissor (o banco do cartão cobra juros do cliente). Vale quando a cobrança não diz quem paga os juros.
Imprimir o comprovante na maquininha	Marcado, a maquininha imprime o comprovante do cartão.
URL do webhook	O endereço que você cadastra na Pagar.me. Não dá para editar: só copiar.

A etiqueta ao lado de Integração Stone mostra a situação da empresa: Ativa (cobrando pelo PDV), Inativa (a chave já foi salva, mas a integração está desmarcada) ou Não configurada (a Secret Key ainda não foi informada).

Editar, inativar ou excluir uma maquininha

A aba Maquininhas lista Nome, Número de série (S/N), Caixa do PDV e Situação (Ativa ou Inativa). Com mais de uma empresa, aparece também a coluna Empresa.
Com mais de uma empresa na Stone, a janela Adicionar maquininha pede também a Empresa da maquininha. Na edição, a empresa não pode ser trocada.
Editar: abre a janela Editar maquininha, para mudar o número de série, o nome ou a situação. Clique em Salvar.
Inativar: na edição, desmarque Ativa. Inativa, a maquininha recusa as cobranças do caixa que a usa.
Excluir: clique em Excluir e confirme em Excluir. A maquininha sai da lista do PDV, e o caixa que já usa ela passa a ter a cobrança recusada até escolher outra. As cobranças já feitas continuam registradas.

Acompanhar as cobranças

A aba Pagamentos mostra cada cobrança enviada para a maquininha, com Data, Descrição e a maquininha, Forma (crédito, débito, voucher ou Pix, com a bandeira e as parcelas), Valor e Situação. Role a lista para carregar mais.

Na busca (Nº, descrição, NSU, autorização, referência...), digite o número da cobrança, a descrição, o NSU (o número da transação), a autorização ou a referência.
Filtre pelo período (Data inicial e Data final), pela Situação, pela Maquininha e, com mais de uma empresa, por Empresas. Clique em Atualizar para buscar de novo.
Em telas menores, como a do celular, os filtros ficam no botão + Filtros. Escolha e clique em Filtrar, ou em Limpar Filtros para tirar todos.

Situações da cobrança

Situação	O que quer dizer
Criada	A cobrança foi registrada no VendaSimples e ainda não foi enviada para a Stone.
Aguardando pagamento	A cobrança está na maquininha, esperando o pagamento.
Paga	O pagamento foi aprovado.
Paga em parte	Só uma parte do valor foi paga. A lista mostra quanto já foi pago.
Cancelada	A cobrança foi cancelada antes de ser paga.
Falhou	A criação da cobrança na Stone deu errado. Abra a cobrança e veja o aviso no topo, quando houver.
Estornada	O pagamento foi devolvido ao cliente, pela maquininha ou pelo Portal Stone.

Ver os detalhes de uma cobrança

Clique na cobrança para abrir a janela Cobrança, com o número dela no título e a situação e o valor no topo. Se houver um aviso sobre a cobrança, ele aparece logo abaixo. A janela tem três abas:

Resumo: empresa, maquininha, valor, valor pago, forma, parcelamento, cliente e origem (Venda do PDV, Pedido ou Ordem de serviço). Mostra também a última transação capturada (NSU, autorização, bandeira), as datas e os itens cobrados.
Cobranças: cada pagamento passado na maquininha, com Paga em, Valor, Situação (Paga ou Estornada), Bandeira, NSU e Autorização. Quando o pagamento é dividido, cada parte aparece numa linha.
Webhooks: os avisos que a Stone mandou sobre essa cobrança. Só fica gravado o aviso que acha a cobrança: venda feita direto na maquininha, sem passar pelo PDV, não aparece aqui.

Verificar uma cobrança na Stone

Se a situação não mudou depois que o cliente passou o cartão, o aviso da Stone pode ter atrasado. Abra a cobrança e clique em Verificar na Stone. Aparece Cobrança conferida na Stone. e a situação é atualizada, também na lista. Se o botão estiver apagado, a cobrança não chegou a ser criada na Stone.

Cancelar uma cobrança

Abra a cobrança
Na aba Pagamentos, clique na cobrança. O botão Cancelar cobrança só aparece quando ela ainda pode ser cancelada.
Informe o motivo
Clique em Cancelar cobrança. Se quiser, escreva o Motivo (opcional).
Confirme
Clique em Cancelar cobrança de novo. A cobrança sai da maquininha e o pedido é fechado na Stone. Se um caixa do PDV estiver esperando por ela, ele vê a cobrança como cancelada. Aparece a mensagem Cobrança cancelada.

Cancelar cobrança não é estorno

O pagamento já aprovado volta para o cliente só pela própria maquininha, no menu Cancelamento, ou pelo Portal Stone. Numa cobrança Paga em parte, cancelar só deixa de cobrar o restante: o que já foi pago continua pago. Para cancelar a nota da venda no PDV, veja como cancelar a NFC-e do PDV.

Erros comuns

Mensagem	O que fazer
Só o administrador do grupo acessa a área Stone.	Seu usuário não é administrador. Peça ao administrador do grupo para fazer a configuração.
Nenhuma empresa com a extensão Stone contratada.	Nenhuma empresa do grupo tem a extensão Stone. Contrate a extensão para a empresa que vai usar a maquininha.
Informe o Stone Code para ativar a integração	Com Integração ativa marcada, o Stone Code é obrigatório. Preencha o campo ou desmarque a integração.
Informe a Secret Key para ativar a integração	A chave ainda não foi salva para essa empresa. Preencha a Secret Key antes de ativar.
Não foi possível copiar. Selecione a URL e copie manualmente.	O navegador não deixou copiar. Selecione o texto da URL do webhook e copie com `Ctrl` + `C`.
A configuração gravada está em Listagem de pedidos: salve para passar para Pagamento direto.	Clique em Salvar configuração para a empresa voltar ao fluxo Pagamento direto.
Informe o número de série da maquininha	Digite o S/N que está na etiqueta atrás da maquininha.
Escolha a empresa da maquininha	Com mais de uma empresa na Stone, escolha a Empresa antes de salvar a maquininha.
A cobrança foi paga antes do cancelamento. Para devolver, estorne na maquininha ou no Portal Stone.	O cliente pagou antes do cancelamento chegar, e a cobrança continua paga. Para devolver o dinheiro, faça o estorno na maquininha (menu Cancelamento) ou no Portal Stone.

Perguntas frequentes

A cobrança passou na maquininha, mas a situação não mudou. O que faço?

Abra a cobrança na aba Pagamentos e clique em Verificar na Stone. Se acontecer sempre, confira se a URL do webhook está cadastrada no dashboard da Pagar.me, em Configurações > Webhooks.

Posso usar o TEF e a Stone na mesma forma de pagamento?

Não. Uma forma de pagamento abre o TEF ou a maquininha Stone, nunca os dois. Veja como receber cartão pelo TEF e as formas de pagamento.

Onde vejo os dados do cartão de uma venda do PDV?

Em PDV > Vendas, ao visualizar a venda, o pagamento pela Stone mostra a bandeira, o NSU e a autorização. Veja como consultar as vendas do PDV.