# Como funciona

O programa de selos, os casos de cada venda e o glossário.

## 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.

## Quem faz o quê

- A loja define o programa. No painel do GIRO, a loja escolhe o valor mínimo da compra, quantos selos completam a cartela e qual é a recompensa.
- O cliente junta selos. Cada compra que vale selo soma na cartela do cliente. A cartela completa vale a recompensa.
- O seu PDV avisa cada venda. O 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.

**Cliente identificado (credit.state = efetivado)**

```
VOCÊ ESTÁ QUASE LÁ!
Faltam 2 selos para o prêmio: 1 cookie.
Selos: 8 de 10
Saldo de 10/02/26 14:32
Fidelidade por GIRO
```

**Cliente não identificado (credit.state = pendente)**

```
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
```

**Cartela completa (card.completed_now = true)**

```
PARABÉNS, CARTELA COMPLETA!
Você ganhou: 1 cookie.
Peça o seu prêmio no caixa.
Selos: 10 de 10
Saldo de 10/02/26 14:32
Fidelidade por GIRO
```

## 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 selo: Pelo valor mínimo da loja.
- Quantos selos: Pela regra do programa.
- Se o cliente é identificado: Pelo telefone e pelo aceite no GIRO.
- O teto por venda: Valor acima do teto da loja é recusado.
- A validade do QR: O prazo é da loja e aparece no cupom.
- A imagem do cupom: Muda sozinha quando a regra muda.

## Glossário

| Termo | Significado |
|---|---|
| Loja | O estabelecimento que tem o programa de selos no GIRO. |
| Programa | A regra da loja: valor mínimo, quantos selos completam a cartela e qual é a recompensa. |
| Selo | O crédito que o cliente ganha na compra. |
| Cartela | O conjunto de selos de um cliente na loja. A cartela completa vale a recompensa. |
| Cliente identificado | Cliente com telefone e aceite no GIRO. O selo entra na hora. |
| Selo pendente | Selo de uma venda sem cliente identificado. Entra na cartela quando o cliente ativa pelo QR. |
| Conexão | A ligação entre o seu PDV e uma loja, em um ambiente, com um token próprio. |
| Ambiente | Sandbox, para testes, ou produção. |

[Ver o fluxo do nível Venda](/niveis.html#n2) · [Ir ao início rápido](/guias.html#inicio)

Fonte: https://developers.giro.app.br/como.html