# GIRO Desenvolvedores

Selos no cupom do seu PDV com uma chamada de API.

# 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](/acesso.html)
- [Entender como funciona](/como.html)

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

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

- **Nível 1 · Cupom** (Em breve): 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.
- **Nível 2 · Venda** (Disponível): 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.
- **Nível 3 · Completo** (Em breve): O 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](/v1.yaml) · [MCP do desenvolvedor](/mcp.html) · [llms.txt](/llms.txt) · Toda página existe em Markdown.

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

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