Loy API · piloto com parceiros Documentação para quem desenvolve a integração.

Loy API

Conecte o seu sistema de vendas, agenda ou loja virtual ao programa de fidelidade do Loy. O seu sistema registra; o Loy cuida dos pontos, das recompensas e da experiência do cliente final.

Como funciona

  • Toda chamada usa uma chave de API da empresa, no cabeçalho Authorization.
  • A chave identifica a empresa: você nunca envia o código da empresa na requisição.
  • Respostas em JSON, datas com fuso e erros com um code estável para o seu sistema tratar.
  • Mesmas regras do app do Loy: pontos e recompensas seguem o programa configurado pela empresa.

O que dá para fazer

Clientes
Cadastrar, atualizar e encontrar pelo ID do seu sistema
Ver na referência →
Visitas
Registrar a venda e somar pontos com as regras do programa
Ver na referência →
Recompensas
Consultar pelo código do cliente e resgatar no caixa
Ver na referência →
Avisos (webhooks)
Receber no seu sistema o que acontece no Loy
Ver na referência →

Por onde começar

  1. Primeiros passos: peça acesso e faça a primeira chamada.
  2. Fluxo no caixa: o roteiro completo, do cliente ao resgate, sem travar a venda.
  3. Convenções: IDs, cadastro sem duplicar e paginação.
  4. Referência: cada endpoint, com exemplos.

O acesso é liberado pela equipe do Loy. Pedir acesso.