A página Como carimbar

A página Como carimbar do painel de administração lista oito formas de carimbar: Manual, Kiosk Mode, QR do recibo fiscal, QR impresso no seu recibo, Terminal Mode, Delivery Inserts, Integração de API e Autopilot Mode. Cada forma mostra seus passos, onde é configurada e, quando precisa de um, o login de funcionário com que se entra.
A página mostra uma das duas formas por recibo: QR do recibo fiscal quando o país da sua empresa é um daqueles em que os recibos fiscais podem ser escaneados, e QR impresso no seu recibo em todos os outros lugares. Enquanto sua empresa não tiver o que uma forma exige, a forma avisa: Integração de API pede que você crie primeiro uma chave de API, e QR do recibo fiscal pede que você adicione primeiro uma caixa registradora ou um código de empresa.
Todo selo é dado por meio de um login de funcionário: o que está conectado no 7Stamp Scanner, o dono da chave de API ou aquele a que a fonte de recibos está vinculada.
Podemos operar o programa quase sem equipe?
Sim. No Kiosk Mode, os compradores escaneiam o próprio cartão em um tablet, o Autopilot Mode carimba todo cartão que um leitor de QR físico lê, e com QR do recibo fiscal, QR impresso no seu recibo, Delivery Inserts e Integração de API ninguém no balcão carimba nada. Como carimbar mostra as oito formas.
Por que Como carimbar mostra QR do recibo fiscal e não QR impresso no seu recibo?
A página mostra a forma por recibo que se aplica ao país da sua empresa — QR do recibo fiscal onde os recibos fiscais podem ser escaneados, QR impresso no seu recibo em todos os outros lugares.
Como carimbar pede que eu crie primeiro uma chave de API. Por quê?
A Integração de API precisa de uma chave de API antes que seu sistema possa carimbar, e a página avisa isso até que uma exista. Da mesma forma, QR do recibo fiscal pede primeiro uma caixa registradora ou um código de empresa.
Todo selo fica ligado a um login de funcionário?
Sim — ao que está conectado no 7Stamp Scanner, ao dono da chave de API ou àquele a que a fonte de recibos está vinculada.
Qual forma combina com sua empresa
O guia Como carimbar abre com seis imagens: Manualmente no aplicativo, Tablet no caixa, o recibo, Dispositivo de pagamento, Delivery Inserts e Automaticamente via API. Cada uma diz quem dá o selo — Pela equipe, Pelo comprador, Durante o pagamento ou Automático —, e Manualmente no aplicativo é marcado como Recomendado. O Autopilot Mode não tem imagem própria; você chega a ele na página.
Na página, cada forma diz, abaixo do nome, para quem é indicada:
| Forma | Indicada para |
|---|---|
| Manual | Salões, spas, restaurantes e empresas de serviços |
| Kiosk Mode | Cafés, padarias, balcões e varejo movimentado |
| Terminal Mode | Lojas com dispositivos de pagamento Android no caixa |
| Delivery Inserts | Entrega, pedidos para viagem e pedidos online |
| Integração de API | Empresas com POS, loja online ou sistema próprio |
QR do recibo fiscal, QR impresso no seu recibo e Autopilot Mode dizem como a forma funciona, em vez de para quem é indicada.
Por qual forma devemos começar?
Como carimbar marca Manual, Manualmente no aplicativo, como Recomendado. Ela é indicada para salões, spas, restaurantes e empresas de serviços. O Kiosk Mode é indicado para cafés, padarias, balcões e varejo movimentado.
Vendemos por aplicativos de entrega e para viagem. Qual forma combina?
Delivery Inserts — Como carimbar a sugere para entrega, pedidos para viagem e pedidos online.
Temos nossa própria loja online. Qual forma combina?
Integração de API, para empresas com POS, loja online ou sistema próprio.
Por que o Autopilot Mode não está entre as imagens?
O guia abre com seis imagens, e o Autopilot Mode não é uma delas. Você chega a ele na própria página Como carimbar.
Manual
A equipe encontra o cartão do comprador no 7Stamp Scanner — pelo QR ou com Encontrar comprador — e adiciona os selos manualmente, quantos quiser.
A equipe precisa do 7Stamp Scanner e do login e da senha de um login de funcionário. Como entrar, encontrar um cartão e adicionar ou remover selos está no artigo 7Stamp Scanner, em Manual.
Do que a equipe precisa para o Manual?
Do 7Stamp Scanner e do login e da senha de um login de funcionário. A página Como carimbar mostra o login de funcionário com que se entra.
Posso adicionar selos ao cartão de um comprador no painel de administração?
Não. Os selos não podem ser adicionados nem removidos no painel de administração. A equipe faz isso no 7Stamp Scanner, ou os selos chegam pelas outras formas de carimbar.
O comprador está sem o telefone. A equipe ainda pode carimbar?
Sim. Encontrar comprador, no 7Stamp Scanner, procura o cartão por nome, e-mail, telefone ou número do cartão.
Kiosk Mode
Um dispositivo com o 7Stamp Scanner fica voltado para os compradores, e eles escaneiam o próprio cartão com a câmera dele. A equipe inicia o Kiosk Mode uma vez, para um cartão de selos.
A configuração, a proteção contra escaneamentos duplos e como sair do Kiosk Mode estão no artigo 7Stamp Scanner, em Kiosk Mode.
O caixa precisa pressionar algo no Kiosk Mode?
Não. Os compradores escaneiam o próprio cartão no dispositivo voltado para eles.
Um quiosque pode carimbar dois cartões de selos diferentes?
Não. O Kiosk Mode funciona para o único cartão de selos escolhido ao iniciá-lo; um cartão de outro cartão de selos é recusado.
De que dispositivo preciso para o Kiosk Mode?
Um dispositivo que rode o 7Stamp Scanner e tenha câmera — os compradores escaneiam o cartão com ela.
QR do recibo fiscal
O comprador escaneia o QR fiscal que o recibo já traz, com o botão Digitalizar recibo no chatbot da sua empresa, e o 7Stamp transforma o recibo em selos. O 7Stamp busca o recibo no serviço fiscal do país, então nenhuma integração com POS é necessária.
Funciona apenas em alguns países e só pelo seu próprio bot no Telegram ou no WhatsApp. Os países, as fontes de recibos e todas as verificações estão no artigo Leitura de recibos.
Precisamos de uma integração com POS para o QR do recibo fiscal?
Não. O 7Stamp busca o recibo no serviço fiscal do país.
Os compradores podem escanear o recibo sem um chatbot?
Não. O botão Digitalizar recibo existe apenas no bot da empresa no Telegram ou no WhatsApp, não na página web do cartão nem em My 7Stamp.
O QR do recibo fiscal funciona no meu país?
Como carimbar só o mostra quando o país da sua empresa o suporta; os países estão listados em Leitura de recibos. Nos outros, use QR impresso no seu recibo.
QR impresso no seu recibo
Esta forma funciona em qualquer país. Seu POS imprime um QR do 7Stamp no recibo, conectado pela API ou por uma integração pronta, e o comprador o escaneia depois de pagar. Um POS sem integração pode, em vez disso, imprimir códigos de selo nos recibos (veja Delivery Inserts e códigos de selo abaixo).
As integrações prontas ficam em Configurações → API e integrações: no caixa, Poster, Toast, seu próprio POS pela API e um pedido para um POS que ainda não está conectado. Elas são descritas em API, webhooks e integrações.
Não estamos em um país com recibos fiscais. Os compradores ainda podem ganhar selos com um recibo?
Sim. QR impresso no seu recibo funciona em qualquer país — seu POS imprime um QR do 7Stamp, e o comprador o escaneia depois de pagar.
Meu POS não está na lista. O que posso fazer?
Conecte-o pela API ou envie um pedido para ele em API e integrações. Até lá, imprima códigos de selo nos seus recibos.
O Poster está disponível fora do painel de administração do próprio 7Stamp?
Não. O Poster precisa de uma chave de API e só é oferecido no painel de administração do próprio 7Stamp, não com White Label.
Terminal Mode
O 7Stamp Scanner roda no dispositivo POS Android do caixa. Depois do pagamento, a equipe toca em Atender comprador, o dispositivo mostra um QR de uso único, e o comprador o escaneia com o telefone — um comprador sem o cartão de selos o recebe junto com os selos.
A instalação, o valor para um cartão de selos Por quantia e como procurar um comprador antes estão no artigo 7Stamp Scanner, em Terminal Mode.
O comprador precisa ter o cartão de selos antes de pagar?
Não. Um comprador que não tem o cartão o recebe, junto com os selos, quando escaneia o QR.
O caixa precisa escanear o telefone do comprador no Terminal Mode?
Não. O dispositivo mostra um QR, o comprador o escaneia com o telefone, e o resultado aparece sozinho no dispositivo.
Um QR de Atender comprador pode ser usado duas vezes?
Não. Atender comprador mostra um QR de uso único.
Delivery Inserts e códigos de selo

Um código de selo é um código de uso único de um cartão de selos que dá selos. Ele é entregue como um QR para imprimir, um link ou o próprio código. Um comprador sem o cartão recebe o cartão com ele, e os selos vão para esse cartão.
Delivery Inserts é uma forma de usar códigos de selo, não algo separado: você imprime uma série de códigos de selo, coloca um em cada pedido de entrega ou para viagem, e o comprador o escaneia em casa. Os códigos de selo ficam em Ferramentas de marketing.

Cada código de uma série dá ou um número de selos, de um até o total do cartão de selos, ou um valor de compra. Uma série tem de um a cem códigos.

Um código com valor calcula os selos pelo preço do selo do cartão de selos quando o comprador o abre. Um valor abaixo de um preço de selo dá o cartão sem selo, e o comprador é informado do motivo.

Cada código de selo funciona uma vez. Um comprador que abre um já usado não recebe selos e vê que ele já foi usado; um comprador que não tinha cartão recebe o cartão mesmo assim. Se dois compradores abrirem o mesmo código no mesmo instante, só um recebe os selos. Quando sua empresa tem um bot no Telegram ou no WhatsApp, o link de um código de selo abre o bot, e o cartão passa a ficar no chat; caso contrário, abre a página web do cartão.
Quantos selos um código de selo pode dar?
De um até o total do cartão de selos, ou um valor de compra que é convertido em selos pelo preço do selo quando o comprador abre o código.
Quantos códigos de selo posso gerar de uma vez?
De um a cem códigos por série. Gere outra série quando precisar de mais.
Um comprador escaneou um código de selo duas vezes. Ele recebeu os selos duas vezes?
Não. Cada código de selo funciona uma vez; na segunda vez, o comprador vê que ele já foi usado.
Preciso de uma configuração separada para Delivery Inserts?
Não. Delivery Inserts é uma forma de usar códigos de selo — imprima uma série e coloque um código em cada pedido de entrega ou para viagem.
Integração de API

Seu POS, sua loja online ou seu próprio software carimba pela API com uma chave de API criada em API e integrações para um login de funcionário; toda chamada age como esse login de funcionário. Pela API, um sistema emite cartões e adiciona selos pelo seu próprio identificador de comprador.
Um escaneamento pela API envia um número de selos, um valor de compra ou as linhas do recibo. Um número de selos prevalece sobre o valor e a regra de ganho; zero selos significa “contar a partir do valor ou do recibo”. A API só adiciona selos: removê-los é feito no 7Stamp Scanner. Antes de um escaneamento, o sistema pode perguntar o que ele daria; a resposta não salva nada e não conta nenhuma Card Operation, e funciona para um comprador que ainda não tem cartão.
Chaves de API, webhooks e as integrações prontas estão em API, webhooks e integrações.
Podemos adicionar selos pelo nosso próprio CRM ou POS?
Sim, pela API. Crie uma chave de API para um login de funcionário em API e integrações; seu sistema passa então a emitir cartões de selos e adicionar selos pelo seu próprio identificador de comprador.
Nosso sistema pode retirar selos pela API?
Não. O escaneamento da API só adiciona selos. Os selos são removidos no 7Stamp Scanner.
Nosso sistema envia um número de selos e também um valor. Qual conta?
O número de selos. Ele prevalece sobre o valor e a regra de ganho; envie zero selos para que sejam contados a partir do valor ou do recibo.
Podemos mostrar ao comprador o que uma compra vai dar antes de carimbar?
Sim. A API pode perguntar o que um escaneamento daria; a resposta não salva nada e não conta nenhuma Card Operation.
Autopilot Mode
Um leitor de QR físico no balcão carimba todo cartão que lê, um selo por cartão, sem ninguém pressionar nada. O comprador mostra o cartão, e o selo é adicionado.
O Autopilot Mode é uma chave no Manual do 7Stamp Scanner e precisa de um leitor de QR físico: um cartão lido pela câmera do telefone apenas abre o cartão do comprador. Os detalhes estão no artigo 7Stamp Scanner, em Autopilot Mode.
O Autopilot Mode pode usar a câmera do telefone?
Não. Com o Autopilot Mode ativado, um cartão lido pela câmera apenas abre o cartão do comprador. Os selos automáticos precisam de um leitor de QR físico.
Quantos selos o Autopilot Mode adiciona?
Um selo para cada cartão que o leitor de QR físico lê.
Onde o Autopilot Mode é ativado?
No 7Stamp Scanner, na tela Manual.
Quantos selos uma compra dá
Cada cartão de selos tem uma única regra de ganho, definida no editor em Como os compradores ganham selos:
- Por pedido — um selo por compra, qualquer que seja o valor.
- Por quantia — um selo para cada preço de selo inteiro contido no valor da compra, arredondando para baixo, então uma compra pode dar vários selos: uma compra de dois preços de selo e meio dá dois.
- Por item — um selo para cada unidade de um produto cujo código está na lista do cartão de selos, então duas unidades de um produto da lista dão dois selos. Os códigos são comparados sem diferenciar maiúsculas de minúsculas.
Uma compra abaixo de um preço de selo, ou um recibo sem nenhum dos produtos da lista, é um escaneamento válido que não adiciona selo. O comprador é informado do motivo — no caso de um valor, quanto faltou — e nada é enviado a ele.
Por quantia e Por item funcionam sempre que um valor de compra ou as linhas do recibo chegam ao 7Stamp: Terminal Mode (Por quantia), recibos fiscais, códigos de selo com valor, a API, integrações com POS e Toast. Manual, Kiosk Mode e Autopilot Mode adicionam um número de selos, nunca um valor: Kiosk Mode e Autopilot Mode adicionam um selo por escaneamento; o Manual, o número que a equipe escolhe.
Os selos podem ser dados pelo valor da compra?
Sim. Escolha Por quantia para o cartão de selos. O valor chega ao 7Stamp pelo Terminal Mode, por recibos fiscais, por códigos de selo com valor, pela API e por integrações com POS. O Manual não tem valor — a equipe escolhe o número de selos.
Com Por quantia, uma compra grande dá vários selos?
Sim. Cada preço de selo inteiro contido no valor dá um selo, arredondando para baixo — dois preços de selo e meio dão dois selos.
A compra de um comprador ficou abaixo do preço do selo. O que acontece?
O escaneamento é válido, mas não adiciona selo. O comprador é informado de quanto faltou; o cartão dele não muda.
O Kiosk Mode carimba por valor?
Não. O Kiosk Mode e o Autopilot Mode adicionam um selo por escaneamento, qualquer que seja a regra de ganho.
Qual cartão de selos recebe os selos
Quando a equipe escaneia o cartão de um comprador, os selos vão para o cartão de selos desse cartão. Recibos e chamadas de API não trazem cartão, então o cartão de selos que eles carimbam é escolhido por login de funcionário, na página dele, em Selos automáticos.
Um login de funcionário sem escolha própria usa o cartão de selos padrão da empresa. Esse padrão não tem configuração própria: quando um login de funcionário é criado enquanto a empresa tem exatamente um cartão de selos e nenhum padrão, esse cartão se torna o padrão. Com só um cartão de selos na empresa, a escolha fica travada nele.
Com dois ou mais cartões de selos e nenhum escolhido — nem para o login de funcionário nem como padrão —, os recibos fiscais dele não dão selos, e as chamadas de API que não indicam um cartão de selos são recusadas.
Temos dois cartões de selos. Qual deles os recibos carimbam?
O escolhido para o login de funcionário da fonte de recibos, em Selos automáticos. Sem nenhum escolhido e sem padrão, os recibos não dão selos.
Onde escolho o cartão de selos para chamadas de API?
Na página do login de funcionário, em Selos automáticos. Toda chamada feita com a chave de API desse login de funcionário o usa, a menos que a chamada indique um cartão de selos.
Selos automáticos muda o que um escaneamento de cartão no 7Stamp Scanner carimba?
Não. Um cartão escaneado é carimbado no próprio cartão de selos.
Quando um escaneamento não dá selo
Um escaneamento não dá selo a um cartão de outra empresa, a um cartão excluído no painel de administração, a um cartão cujo dono excluiu o perfil ou a um cartão de um cartão de selos desativado ou excluído. Um comprador cujo cartão foi excluído adiciona o cartão de novo e recebe um novo.
Os escaneamentos não têm limite de frequência: o mesmo cartão pode ser carimbado de novo imediatamente, tanto pelo 7Stamp Scanner quanto pela API. Só o Kiosk Mode se protege contra um escaneamento duplo, do lado dele.
Os selos no cartão de um comprador não expiram.
Os selos expiram?
Não. Os selos no cartão de um comprador não expiram; só os vales-presente podem ter data de término.
A equipe pode carimbar o mesmo cartão duas vezes seguidas?
Sim. Os escaneamentos não têm limite de frequência. Só o Kiosk Mode bloqueia um segundo escaneamento seguido do mesmo cartão.
Por que o cartão de um comprador não recebeu selo?
O cartão pode pertencer a outra empresa, ter sido excluído, pertencer a um comprador que excluiu o perfil ou pertencer a um cartão de selos desativado ou excluído.
NFC, Apple VAS e Google Smart Tap
O NFC não adiciona selos: o 7Stamp Scanner lê o QR de um cartão ou o número dele, e nem o scanner nem o lado do comprador leem NFC.
O NFC pode atrair compradores. Você pode gravar o link de adesão de um cartão de selos na sua própria etiqueta NFC, para que um toque do telefone abra o cartão como faz o escaneamento do QR de adesão. O 7Stamp em si não tem configuração de NFC.
Apple VAS e Google Smart Tap, em que o dispositivo de pagamento reconhece o cartão de fidelidade antes do pagamento, podem ser configurados com os parceiros do 7Stamp. O parceiro fornece o certificado do protocolo, e o dispositivo precisa aceitar as chaves de criptografia da Apple e do Google.
O NFC adiciona selos?
Não. Os selos vêm das formas da página Como carimbar; o 7Stamp Scanner lê o QR de um cartão ou o número dele, não NFC.
Os compradores podem obter o cartão de selos tocando uma etiqueta NFC?
Sim. Grave o link de adesão do cartão de selos na sua própria etiqueta NFC; um toque abre o cartão como o QR de adesão.
Um dispositivo de pagamento pode reconhecer o cartão de fidelidade antes do pagamento com Apple VAS ou Google Smart Tap?
Sim, com os parceiros do 7Stamp. Você precisa do certificado do protocolo fornecido pelo parceiro, e o dispositivo precisa aceitar as chaves de criptografia da Apple e do Google.