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.
Cartão fidelidade lido — desconto de 10% aplicado
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.
Uma amostra da documentação interativa da API que o fornecedor do seu PDV usa para conectar o seu caixa.
O caixa lê o QR Code de fidelidade e recebe o nome do cliente, o número da visita e os saldos.
Descontos percentuais ou em valor voltam como ações que o caixa aplica na conta.
Cupons, recompensas de pontos e pagamentos com crédito de cashback são resgatados direto no caixa.
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 }{
"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.
É assim que funciona uma compra com o caixa conectado.
POST /api/pos/scaninput_requiredPOST /api/pos/scan/{scan_id}completedA 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.
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 APIO 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.
Os dois funcionam. Escolha o que combina com o seu balcão.
O que donos de negócio e fornecedores de PDV mais perguntam.
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.
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.
É 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.
O BonusQR as emite sob consulta. Uma chave pode ser limitada a uma única unidade do seu negócio.
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.
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.
Sim. Há documentação interativa da API, além de um caixa de demonstração que o seu fornecedor pode usar para testes.
Para WooCommerce e Shopify existem integrações prontas no plano Basic.
Conte para nós qual PDV você usa e preparamos uma proposta para a integração.
