Nível 1 · Cupom
Para PDV sem rede no caixa: o QR assinado leva a venda ao GIRO pelo celular do cliente. Exige PDV com servidor ou instalado com armazenamento protegido; PDV de navegador usa o nível 2.
Para PDV sem rede no caixa. O PDV não chama a API na venda. Se a mesma venda chegar também pela API, vale a venda da API.
O caixa funciona mesmo sem internet.
O PDV assina o QR com o segredo de assinatura da loja, diferente do token: loja, venda, valor e data.
O QR sai no cupom, como no nível Venda.
O cliente abre o QR no celular.
O GIRO confere a assinatura, o uso único, a validade de 7 dias, o teto por QR e o limite diário da loja, e credita o selo.
O que o cliente leva no cupom
Sem rede, o PDV monta este bloco com o QR assinado. A cartela não aparece, porque o PDV não sabe o saldo do cliente no momento da venda.
impressos pelo seu PDV
O que o PDV usa
- Sem chamada de API no caixa
Nível 2 · Venda
O PDV avisa o GIRO de cada venda e imprime a imagem do GIRO no cupom. Uma chamada por venda, sem guardar segredo de assinatura.
O cliente já aceitou o GIRO e informa o telefone no caixa. O selo entra na hora.
No caixa, o cliente diz o telefone. O campo é opcional.
O PDV envia a chave da venda, o total, a hora e o telefone.
POST /v1/salesO GIRO confere o programa, o valor mínimo e o teto, e acha o cliente pelo telefone.
A resposta traz o crédito efetivado, a cartela e o bloco do GIRO, em texto e em imagem.
credit.state = efetivadoO PDV imprime receipt.lines ou receipt.image no fim do cupom.
receipt.lines · receipt.imageO cupom mostra quantos selos faltam para a recompensa.
O que o cliente leva no cupom
O bloco do GIRO que a API devolve, em texto (receipt.lines) ou em imagem (receipt.image). O PDV escolhe e imprime no fim do cupom.
impressos pelo seu PDV
1 cookie
O cliente não informa o telefone ou ainda não aceitou o GIRO. O selo fica guardado até o cliente ativar pelo QR.
O cliente não informa o telefone, ou o telefone ainda não tem aceite no GIRO.
O PDV envia a venda do mesmo jeito. Não há fluxo separado.
POST /v1/salesO GIRO cria um QR de ativação, com validade definida pela loja.
credit.state = pendenteA resposta traz o claim e o bloco do GIRO com o QR de ativação e o código curto.
claim · receipt.qr · receipt.short_codeO PDV imprime o bloco do GIRO. No texto, o QR entra depois da primeira linha; na imagem, já vem desenhado.
receipt.lines · receipt.imageO cliente abre o QR no celular, informa o telefone e aceita o programa. O GIRO credita o selo.
O que o cliente leva no cupom
O bloco do GIRO que a API devolve, em texto (receipt.lines) ou em imagem (receipt.image). O PDV escolhe e imprime no fim do cupom.
impressos pelo seu PDV
A venda completa a cartela do cliente identificado. O cupom avisa o prêmio, e o cliente pede o prêmio no caixa.
O cliente se identifica no caixa.
O PDV envia a venda como sempre.
POST /v1/salesO selo desta venda completa a cartela. A resposta traz card.completed_now = true.
card.completed_nowO cupom avisa o prêmio que o cliente ganhou.
receipt.imageO cliente pede o prêmio no caixa, agora ou numa próxima visita.
O que o cliente leva no cupom
O bloco do GIRO quando a venda completa a cartela.
impressos pelo seu PDV
A venda foi desfeita no PDV. O GIRO desfaz o selo, mesmo que o cancelamento chegue antes da venda.
O operador desfaz a venda no caixa.
O PDV usa a mesma chave da venda.
POST /v1/sales/{external_id}/cancelSe a venda já chegou, o GIRO tira o selo. Se ainda não chegou, guarda o cancelamento.
Uma venda que chega depois de cancelada já nasce cancelada, sem selo e sem cupom.
status = canceladaO que o PDV usa
- GET /v1/program
- POST /v1/sales
- POST /v1/sales/{external_id}/cancel
- GET /v1/sales/{external_id}
- GET /v1/connection
Nível 3 · Completo
O nível 2 mais a identificação do cliente e o resgate do prêmio no caixa, com o resgate na nota fiscal.
Além da venda, o caixa identifica o cliente e troca a recompensa na hora.
O cliente se identifica no caixa.
O PDV consulta o cliente e a carteira pelo Open Delivery (Customer e Loyalty): selos e prêmio disponível.
Open Delivery LoyaltyO cliente quer usar a recompensa nesta compra.
O PDV cria a referência do resgate e reserva a recompensa.
A recompensa fica reservada, sem ser gasta, até a confirmação.
Com a venda paga, o PDV confirma o resgate. Na nota, o resgate sai como pagamento de fidelidade (tPag 19), com o ID do resgate. Se a venda cai, o PDV cancela a reserva.
O que o cliente leva no cupom
A imagem que a API devolve ao confirmar o resgate. O cupom mostra o prêmio resgatado e a nova cartela.
impressos pelo seu PDV
O que o PDV usa
- Tudo do nível 2
- Consulta de cliente e carteira pelo Open Delivery (Customer e Loyalty)
- Resgate em duas fases (extensão do GIRO): reservar e confirmar
- Na nota: pagamento de fidelidade (tPag 19) com o ID do resgate