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

Primeiros passos

Importante no piloto: use a chave loy_live_ vinculada à empresa de demonstração fornecida pelo Loy. Ela grava dados reais nessa empresa. Não teste com os dados de produção de uma empresa cliente. Chaves loy_test_ ainda não são aceitas e o ambiente isolado de sandbox ainda não está disponível.

1. Peça acesso

Conte sobre o seu sistema em loynow.com/integracoes. Para validar a integração, a equipe do Loy prepara uma empresa de demonstração e emite a primeira chave para ela.

2. Guarde a chave

A chave tem o formato loy_live_XXXXXXXXXXXX_… e é mostrada uma única vez. Guarde em um cofre de segredos ou variável de ambiente do seu servidor — nunca no código, no aplicativo do cliente ou no navegador.

3. Faça a primeira chamada

curl https://loynow.com/api/v1/me \
  -H "Authorization: Bearer $LOY_API_KEY"

A resposta mostra a empresa da chave, os escopos, os limites e o uso do mês:

{
  "company": {
    "id": 123,
    "name": "Sua empresa"
  },
  "api_key": {
    "prefix": "AbCdEfGh1234",
    "name": "Integração PDV",
    "environment": "live",
    "scopes": [
      "customers:read"
    ]
  },
  "limits": {
    "plan": "pilot",
    "requests_per_minute": 60,
    "included_requests": 10000
  },
  "usage": {
    "period_start": "2026-10-01",
    "billable_requests": 0
  }
}

Valores ilustrativos. Os limites da sua chave são os que a sua resposta mostrar.

4. Trate os erros pelo code

Toda falha volta no mesmo formato, com um request_id para você citar se precisar de ajuda. Veja Erros e Limites e quota.

5. Monte o fluxo completo

Com a primeira chamada funcionando, siga o Fluxo no caixa: identificar o cliente, registrar a venda, mostrar o progresso e aceitar a recompensa.

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