Antes de integrar
Como o GIRO funciona no caixa
O GIRO é o programa de fidelidade da loja. O cliente junta selos a cada compra e troca a cartela completa por uma recompensa. O seu PDV liga o caixa ao programa.
🏪
A loja define o programaNo painel do GIRO, a loja escolhe o valor mínimo da compra, quantos selos completam a cartela e qual é a recompensa.⭐
O cliente junta selosCada compra que vale selo soma na cartela do cliente. A cartela completa vale a recompensa.🧾
O seu PDV avisa cada vendaO PDV envia a venda ao GIRO e imprime no cupom a imagem que a resposta traz.O que o cliente leva no cupom
O PDV envia a venda sempre do mesmo jeito. O GIRO decide qual caso se aplica e devolve o cupom certo, na largura da bobina do PDV.
credit.state = efetivado
Cliente identificado
O cliente informou um telefone que já tem aceite no GIRO. O selo entra na cartela na hora, e o cupom mostra quantos selos faltam.
Itens, total e pagamento
impressos pelo seu PDV
impressos pelo seu PDV
VOCÊ GANHOU +1 SELO!
CASA DO COOKIE - SHOPPING CENTRO
CARTELA DE SELOS
8 de 10 selosPrêmio:1 cookie
FALTAM
2
selos para
1 cookie
1 cookie
10/02/26 14:32(••) •••••-4321
VOCÊ GANHOU +1 SELO!
CASA DO COOKIE - SHOPPING CENTRO
CARTELA DE SELOS
8 de 10 selos (faltam 2)
1 cookie
10/02/26 14:32(••) •••••-4321
VOCÊ ESTÁ QUASE LÁ!
Faltam 2 selos para o prêmio: 1 cookie.
Selos: 8 de 10
X X X X X X X X _ _
● ● ● ● ● ● ● ● ○ ○
Saldo de 10/02/26 14:32
Fidelidade por GIRO
FIDELIDADE POR
receipt.imagereceipt.lines
credit.state = pendente
Cliente não identificado
Não houve telefone, ou o telefone ainda não tem aceite. O selo fica guardado. O cliente lê o QR do cupom, aceita o programa e o selo entra na cartela.
Itens, total e pagamento
impressos pelo seu PDV
impressos pelo seu PDV
VOCÊ GANHOU 1 SELO · ATIVE!
CASA DO COOKIE - SHOPPING CENTRO
CARTELA DE SELOS
SELO PENDENTE · ATIVE NO QR
1 de 10 selos (faltam 9)Prêmio:1 cookie
ATIVE SEU SELO AGORA
giro.app.br/c/x7k9m2c3d4p
Você tem 7 dias · vale até 17/02
10/02/26 14:35
VOCÊ GANHOU 1 SELO · ATIVE!
CASA DO COOKIE - SHOPPING CENTRO
CARTELA DE SELOS
SELO PENDENTE · ATIVE NO QR
1 de 10 selos (faltam 9)
1 cookie
ATIVE SEU SELO AGORA
giro.app.br/cadastro/x7k9m2
Você tem 7 dias · até 17/02
10/02/26 14:35
VOCÊ GANHOU 1 SELO NESTA COMPRA!
Leia o QR para ativar o selo.
Sem câmera: giro.app.br/c/x7k9m2c3d4p
Você tem 7 dias · vale até 17/02
Fidelidade por GIRO
FIDELIDADE POR
receipt.imagereceipt.lines
card.completed_now = true
Cartela completa
O selo desta compra completa a cartela do cliente identificado. O cupom avisa o prêmio, e o cliente pede o prêmio no caixa.
Itens, total e pagamento
impressos pelo seu PDV
impressos pelo seu PDV
PARABÉNS, CARTELA COMPLETA!
CASA DO COOKIE - SHOPPING CENTRO
CARTELA DE SELOS
10 de 10 selosPrêmio:1 cookie
VOCÊ GANHOU
1 cookie
Peça no caixa
10/02/26 14:32(••) •••••-4321
PARABÉNS, CARTELA COMPLETA!
CASA DO COOKIE - SHOPPING CENTRO
CARTELA DE SELOS
10 de 10 selosPrêmio:1 cookie
VOCÊ GANHOU
1 cookie
Peça no caixa
10/02/26 14:32(••) •••••-4321
PARABÉNS, CARTELA COMPLETA!
Você ganhou: 1 cookie.
Peça o seu prêmio no caixa.
Selos: 10 de 10
X X X X X X X X X X
● ● ● ● ● ● ● ● ● ●
Saldo de 10/02/26 14:32
Fidelidade por GIRO
FIDELIDADE POR
receipt.imagereceipt.lines
O que o GIRO decide por você
O PDV não implementa nenhuma regra do programa. Ele só envia a venda e imprime a imagem do GIRO.
Se a compra vale seloPelo valor mínimo da loja.
Quantos selosPela regra do programa.
Se o cliente é identificadoPelo telefone e pelo aceite no GIRO.
O teto por vendaValor acima do teto da loja é recusado.
A validade do QRO prazo é da loja e aparece no cupom.
A imagem do cupomMuda sozinha quando a regra muda.
Glossário
LojaO estabelecimento que tem o programa de selos no GIRO.
ProgramaA regra da loja: valor mínimo, quantos selos completam a cartela e qual é a recompensa.
SeloO crédito que o cliente ganha na compra.
CartelaO conjunto de selos de um cliente na loja. A cartela completa vale a recompensa.
Cliente identificadoCliente com telefone e aceite no GIRO. O selo entra na hora.
Selo pendenteSelo de uma venda sem cliente identificado. Entra na cartela quando o cliente ativa pelo QR.
ConexãoA ligação entre o seu PDV e uma loja, em um ambiente, com um token próprio.
AmbienteSandbox, para testes, ou produção.