Usar a API do Reton (visão geral)

IntegraçõesAtualizado em 4 de julho de 20261 min de leitura
Navegar na ajuda
Neste artigo

A API do Reton é a porta para outros sistemas conversarem com ele por código: seu PDV, seu e-commerce ou um sistema próprio podem enviar vendas, cadastrar clientes e consultar saldos automaticamente, sem ninguém digitar no painel. É a mesma lógica de negócio da interface — só que acessível por programação.

A API é para uso técnico. Se você não desenvolve sistemas, pode ignorar este artigo — o painel e a tela do operador já cobrem o uso do dia a dia.

Autenticação por chave

Toda requisição precisa mandar sua chave de API no cabeçalho X-API-Key. É ela que identifica sua empresa e libera o acesso. Você gera e gerencia essa chave nas configurações — veja em chave de API.

A chave é secreta e aparece uma única vez, na hora de gerar. Guarde num lugar seguro e nunca coloque em código público (front-end, repositório aberto). Quem tem a chave tem acesso aos dados da sua empresa.

O que dá pra fazer

  • Criar contatos — enviar novos clientes do seu site ou sistema direto pra base.
  • Registrar interações — mandar vendas do seu PDV, com deduplicação para não contar a mesma venda duas vezes.
  • Estornar interações — reverter uma venda e a fidelidade que ela gerou.
  • Consultar saldo — ler quantos pontos ou quanto de cashback um contato tem.
  • Resgatar recompensas — registrar um resgate e listar os resgates já feitos.

Como as respostas chegam

Toda resposta vem em JSON com um formato padrão: um campo dizendo se deu certo, os dados (ou o erro, com código e mensagem) e um identificador único da requisição, útil pra rastrear problemas com o suporte. Os detalhes de cada endpoint e campo ficam na documentação técnica para desenvolvedores.

Conecte seus sistemas ao Reton

Gere sua chave de API e comece a enviar vendas e contatos automaticamente do seu PDV ou e-commerce.

Perguntas frequentes

Isso foi útil?

Ainda precisa de ajuda?

Não achou o que procurava? A gente responde de gente pra gente.

Comece a recuperar clientes hoje

Grátis para começar. Veja quem está sumindo já no primeiro dia.

Sem cartão de crédito · Cancele quando quiser