Ajuda

Integrações · Documentação técnica

API da Greenn: documentação e autenticação

Atualizado em Leitura de 2 min

Resposta curta

A API da Greenn fica em https://apiadm.greenn.com.br/api/v1 e usa um Personal Access Token (grn_live_...) no header Authorization, no formato Bearer. Você cria o token em Sistema > Tokens e Api Key.

Esta página reúne o que você precisa para integrar seus sistemas à Greenn por API. A referência completa de cada endpoint está na documentação interativa. Para receber notificações em vez de consultar, veja a documentação do webhook.

URL base

https://apiadm.greenn.com.br/api/v1

Autenticação

Todas as requisições usam um Personal Access Token (token pessoal de acesso) emitido na sua conta Greenn (veja abaixo como criar). Os tokens sempre começam com o prefixo grn_live_ e vão no header Authorization, no formato Bearer:

Authorization: Bearer grn_live_REPLACE_WITH_YOUR_TOKEN

Troque grn_live_REPLACE_WITH_YOUR_TOKEN pelo seu token. Ele é pessoal: não compartilhe nem publique em código aberto.

Onde criar o token

  1. No menu lateral, abra Sistema e clique em Tokens e Api Key. Abre a tela Configurações, na aba Integrações e Tokens.
  2. Na área de tokens pessoais, clique em Criar token. Enquanto você não criou nenhum, aparece a mensagem Nenhum token criado ainda.

    Aba Integrações e Tokens com o Webhook Token e a mensagem Nenhum token criado ainda

Nesta mesma tela ficam as Chaves de acesso (Public Key e API Key, com o botão Gerar novas chaves de acesso) e o Webhook Token (com o botão Gerar novo token).

O que você encontra na API

Esta versão cobre os seguintes domínios da sua loja:

  • Vendas: consulta, listagem e reembolso.
  • Produtos: consulta e listagem dos produtos cadastrados.
  • Ofertas: consulta das ofertas (variações de preço e forma de pagamento) de cada produto.
  • Cupons: gestão completa (criar, listar, consultar, atualizar e excluir).
  • Webhooks: notificações de venda, assinatura e abandono de checkout enviadas para a sua URL.

Isso resolveu?

Sua resposta ajuda a gente a melhorar este artigo.

Ainda com dúvida?

A gente resolve com você

O Mr. Greenn responde na hora e, se for preciso, chama uma pessoa do time.

Ainda não vende na Greenn?

Veja quanto fica com você em cada venda

Coloque o preço do seu produto no simulador. Aqui você não é só um número.

Aqui você não é só um número.