Entrar Criar conta

API de fidelidade do GIRO

Selos no cupom do seu PDV com uma chamada de API

O seu PDV avisa o GIRO de cada venda. O GIRO aplica o programa de selos da loja e devolve a imagem pronta para o cupom. Teste tudo no sandbox antes de ir ao ar.

Criar conta e abrir o sandbox Entender como funciona

Uma chamada, um cupom

A resposta da venda traz o bloco do GIRO pronto, como imagem. O PDV só imprime a imagem no fim do cupom.

Cliente identificado
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
Itens, total e pagamento impressos pelo seu PDV

Do teste à produção em 4 passos

A meta é a primeira venda no sandbox em até 1 hora depois do cadastro. A produção só abre depois da suíte de conformidade.

  1. Crie a conta. O sandbox abre na hora, com loja de teste e token de teste.
  2. Integre no sandbox. Registre vendas na loja de teste e imprima o bloco do GIRO.
  3. Passe na suíte. A suíte de conformidade prova cada caso do caixa.
  4. Vá ao ar. A equipe GIRO aprova a credencial de produção.

Escolha o nível de integração

Cada nível acrescenta chamadas ao anterior. Subir de nível nunca reescreve o que já funciona.

Em breveNível 1 · CupomPara 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.DisponívelNível 2 · VendaO PDV avisa o GIRO de cada venda e imprime a imagem do GIRO no cupom. Uma chamada por venda, sem guardar segredo de assinatura.Em breveNível 3 · CompletoO nível 2 mais a identificação do cliente e o resgate do prêmio no caixa, com o resgate na nota fiscal.

Feito para o seu agente de código

Ligue o MCP do desenvolvedor ao Claude Code, ao Cursor ou a outro agente. Ele lê a documentação, registra vendas de teste e roda a suíte no sandbox.

OpenAPI 3.1 MCP do desenvolvedor llms.txt

O prompt de integração traz o objetivo, o contrato do nível Venda, as regras do cupom e o critério de pronto. Cole no seu agente e receba a primeira versão da integração.