Conecte seu caixa ao seu programa de fidelidade
O BonusQR funciona sozinho, com a leitura feita pelo celular. Se você quer que o caixa também cuide da fidelidade, o fornecedor do seu PDV pode conectá-lo pela nossa API REST documentada — o caixa lê o código do cliente, aplica o desconto e resgata as recompensas em uma só etapa.
- API REST documentada
- Descontos e recompensas no caixa
- Opcional — o BonusQR funciona sem ela

Cartão fidelidade lido — desconto de 10% aplicado
O que é uma integração de fidelidade com o PDV?
Uma integração de fidelidade com o PDV faz o seu caixa conversar com o seu programa de fidelidade. Em vez de escanear em um app separado, a equipe lê o QR Code de fidelidade do cliente no caixa, e o sistema aplica o que o programa concede.
Para isso, o BonusQR oferece uma API REST. O caixa envia o código lido e, se necessário, o valor da compra. O BonusQR responde com o que fazer — aplicar um desconto percentual ou em valor, resgatar um cupom ou uma recompensa de pontos — e com mensagens prontas para a equipe.
A integração é opcional e é feita como um projeto sob medida com o fornecedor do seu PDV. As chaves de API são emitidas pelo BonusQR, e a integração tem orçamento à parte.
O que o seu caixa recebe com uma única leitura
Uma amostra da documentação interativa da API que o fornecedor do seu PDV usa para conectar o seu caixa.
- 1
Identificar o cliente
O caixa lê o QR Code de fidelidade e recebe o nome do cliente, o número da visita e os saldos.
- 2
Aplicar descontos
Descontos percentuais ou em valor voltam como ações que o caixa aplica na conta.
- 3
Resgatar recompensas
Cupons, recompensas de pontos e pagamentos com crédito de cashback são resgatados direto no caixa.
- 4
Mensagens para a equipe
Cada resposta inclui mensagens prontas para a equipe no idioma do seu negócio.
/api/pos/configConfiguração do programa de fidelidade para o caixa/api/pos/scanLer um código no caixa{ "code": "12345", "bill_amount": 12.50 }Responses{
"status": "completed",
"kind": "customer",
"customer": { 1
"name": "Ana Souza",
"visit_number": 12,
"loyalty": { "credit": 13.55 }
},
"actions": [{ 2
"type": "apply_percent_discount",
"percent": 10,
"reason": "Membros do clube de fidelidade"
}],
"messages": [{ 4
"level": "warning",
"title": "Desconto de 10%",
"lines": ["Desconte do valor da conta."]
}],
"rewards_earned": []
}/api/pos/scan/{scan_id}Enviar o valor da compra ou o número de itens/api/pos/scan/{scan_id}/cancelCancelar uma leitura pendenteO fornecedor do seu PDV recebe a documentação interativa da API e um caixa de demonstração para testar a integração.
Como a integração funciona
É assim que funciona uma compra com o caixa conectado.
- ClienteCaixaMostra o QR Code de fidelidade
- CaixaBonusQREnvia o código lido
POST /api/pos/scan - BonusQRCaixaSe preciso, pede o valor da compra
input_required - CaixaBonusQRResponde com o valor que o cliente paga
POST /api/pos/scan/{scan_id} - BonusQRCaixaDevolve desconto, recompensas e mensagens para a equipe
completed - CaixaAplica o desconto e conclui a venda
- BonusQRClienteVê selos, pontos e recompensas no app
A integração foi pensada para que a fidelidade nunca atrase um pagamento: se o BonusQR não responder, a venda continua.
Sem integração, a equipe simplesmente escaneia com um celular ou tablet — o BonusQR funciona totalmente sozinho.
Funciona com todos os programas de fidelidade
A API entende todos os programas da sua oferta. Por exemplo:
As recompensas ganhas no caixa aparecem no app do cliente para a próxima visita.
Cartão de selos — o caixa envia o número de itens
Desconto fixo — uma porcentagem da conta
Cashback — o crédito paga a conta como desconto em valor
Cupom de recompensa — resgatado no pagamento
Pontos — uma recompensa do catálogo resgatada no caixa
Recompensa por gasto — a compra conta para o próximo cupom
REST APIFeito para o caixa de verdade
O caixa faz a leitura na hora do pagamento. Se o BonusQR precisar de mais — o valor da compra ou o número de itens —, ele pede e o caixa responde. Uma leitura pendente pode ser cancelada, e a venda nunca fica travada.
- Status claros: concluído, dados necessários, falhou
- Leituras pendentes podem ser canceladas
- Valores na moeda do seu negócio
- Até 60 requisições por minuto por chave
Integração com PDV vs. o leitor do BonusQR
Os dois funcionam. Escolha o que combina com o seu balcão.
Integração com PDV
- Implantação
- Um projeto sob medida com o fornecedor do PDV
- Onde a equipe faz a leitura
- No caixa
- Descontos
- Aplicados automaticamente pelo caixa
- Preço
- Orçamento à parte
Leitor do BonusQR
- Implantação
- Pronto em minutos
- Onde a equipe faz a leitura
- No celular, no tablet ou em um leitor de balcão
- Descontos
- Mostrados à equipe, que os aplica
- Preço
- Incluído em todos os planos
Perguntas sobre a integração com PDV
O que donos de negócio e fornecedores de PDV mais perguntam.
Preciso de integração com PDV para usar o BonusQR?
Não. O BonusQR funciona totalmente sozinho — a equipe lê os códigos dos clientes com um celular, um tablet ou um leitor de balcão. A integração é opcional.
Quais sistemas PDV podem ser conectados?
Qualquer sistema cujo fornecedor consiga chamar uma API REST. O BonusQR não tem plugins prontos para caixas específicos; o seu fornecedor faz a conexão usando a nossa documentação.
Quanto custa a integração?
É um projeto sob medida, então tem orçamento à parte. Escreva para nós e preparamos uma proposta junto com o fornecedor do seu PDV.
Como conseguimos as chaves de API?
O BonusQR as emite sob consulta. Uma chave pode ser limitada a uma única unidade do seu negócio.
O que o caixa recebe depois de uma leitura?
O nome do cliente, o número da visita e os saldos, as ações a aplicar — um desconto percentual ou em valor, um cupom ou uma recompensa de pontos —, as recompensas ganhas e mensagens prontas para a equipe.
E se o caixa precisar de mais informações?
O BonusQR as pede — por exemplo, o valor da compra ou o número de itens — e o caixa responde. Uma leitura pendente também pode ser cancelada.
Existe documentação?
Sim. Há documentação interativa da API, além de um caixa de demonstração que o seu fornecedor pode usar para testes.
E as lojas virtuais?
Para WooCommerce e Shopify existem integrações prontas no plano Basic.
Quer a fidelidade direto no seu caixa?
Conte para nós qual PDV você usa e preparamos uma proposta para a integração.